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English office for current subscription rates or visit our 
homepage www.QLTODAY.com. 


We welcome your comments, suggestions and articles. 
YOU make QL Zeday possible. We are constantly changing 
and adjusting to meet your needs and requirements. Articles 
for publication should be on a 3.5" disk (DD or HD) or sent 
via Email. We prefer ASCII, Quill or text87 format. Pictures 
may be in _SCR format, we can also handle GIF or TIF or 
JPG. To enhance your article you may wish to include 
Saved Screen dumps. PLEASE send a hardcopy of all 
screens to be included. Don't forget to specify where in the 
text you would like the screen placed. 


QL Teday reserves the right to publish or not publish any 
material submitted. Under no circumstances will QL feday 
be held liable for any direct, indirect or consequential 
damage or loss arising out of the use and/or inability to use 
any of the material published in QL Tedey. The opinions 
expressed herein are those of the authors and are not 
necessarily those of the publisher. 


This magazine and all material within is Copyright 2008 
Jochen Merz Software unless otherwise stated. Written per- 
mission is required from the publisher before the reproduc- 
tion and distribution of any/all material published herein. All 
copyrights and trademarks are hereby acknowledged. 


lf you need more information about the UNZIP program 
which is used by our BOOT program to unpack the files, we 
suggest that you visit Dilwyn Jones’ web site where you find 
more information about lots of interesting QDOS software 
and INFOZIP at http:/www.dilwyn.uk6.net/arch/index.html 


This has not been a good autumn for QL publications. Both QL Today and the Quanta 
Magazine have had serious problems. 


About half of QL Today readers received the last issue almost 6 weeks late because of 
problems at the UK side of the operation. The details are in our news section. 


At Quanta a newly appointed editor appears to have gone AWOL and an, already over- 
worked, John Gilpin has had to resume the temporary editorship. This result is severe 
delays in publication and an emergency publishing schedule. 


2008 has been a year of QL gloom. We have seen a drastic reduction in UK trading activi- 
ty. For the first time ever there has been no Quanta show in the South of England. In this 
issue we bring news of changes in the Netherlands that could lead to the closure of 
Sin_QL_Ait. 


In the Spring Quanta had good news for its members, but even this has gone sour. On the 
positive side Dilwyn Jones Is proving his worth as a new committee member and, in the 
background, work is slowly progressing on a reorganisation of the library. Nevertheless 
Quanta has recently been dogged by sheer bad luck that has put some progress on hold, 
and on some issues the officers have shown a lack of flexibility. 


Amidst all the doom and gloom it is important to remember the QL will shortly celebrate its 
quarter centenary. Who would have predicted more than two decades ago, when most of 
the experts had condemned the QL to an early death, that 25 years on we would still be 
alive? How many of the PC’s hardware, software and dot.com companies will be able to 
make this claim 25 years from now? Who could have predicted when Quanta was founded 
in 1984 that a quarter of a century on it would still have about 190 members? QL-ers have 
achieved something remarkable. 


The QL survived through the hard work of many individuals. We have space to name just 
two who have helped to keep QL publications alive. 


The first is John Gilpin. He has never officially been the editor of the Quanta Magazine, but 
always acting editor In his early editorship he had to quickly learn to produce the magazine 
in Page Plus, and then guide it towards electronic publication. During his period of office the 
magazine has improved in reliability and content. Without John’s contribution Quanta could 
have ceased to function about 3 years ago. 


The second person may surprise some readers given recent events, but it is Roy Wood. 
There is a large part of the QL Today operation that remains invisible to the readers. It is a 
complex and time consuming task to produce the magazine, and over the years there 
have been many occasions when consideration was given to closing down. At these times 
it was Roy's energy and enthusiasm that kept others going. Without Roy QL Today could 
have disappeared some years ago. 


The QL still needs workers like these. 


| : 
QL Today at the Crossroads 
The decline in QL trading activity in the UK has 
had a direct impact on QL Today with some rea- 
ders getting the last issue 6 weeks late. 

Earlier this year we reported on the decision of 
Tony Firshman to reduce his QL activities be- 
cause of pressures on his time, and at QL Today 
we feared there would be a knock-on effect that 
would eventually affect the magazine. In particu- 
lar we were aware that in recent years the tra- 
ding pattern of QBranch had changed greatly in 
that the software market is now almost non- 
existent and what trading there is is largely in 
second hand hardware. We were also aware of 
increasing demands on Roy Wood's time from 
outside the QL community. Realistically we had to 
be prepared for the possibility of QBranch, 
through whom about half our readers subscribe, 
closing down. It was clear to us that the struc- 
ture of the magazine in which the continental and 
UK arms have separate administration, distribution 
and financing was inappropriate for a situation in 
which UK trading activity was rapidly diminishing. 
QL Today was founded in 1996 following the col- 
lapse of IQLR and the two founding fathers were 
Jochen Merz and Stuart Honeyball. Shortly after 
the magazine was founded Stuart ceased tra- 
ding and QBranch took over as the UK office. 
Production of the magazine took place in Germa- 
ny, but by far the largest group of subscribers 
were in the UK. It was therefore logical to set up 
two separate arms for the magazine, one on the 
continent and the other in the UK. 

Technically those readers who subscribe to the 
magazine via the UK office do not have a direct 
subscription to QL Today. Their contact is with 
QBranch who then buy in the copies from the 
publisher This structure has worked reasonably 
well over the years, but has come under increa- 
sing strain in the last 12 months. Matters came to 
a head in September of this year when Jochen 
Merz reported to the QL users email group: 

"As | have not had an order from QBranch for 
their QL Today issues and no replies to emails, | 
cannot predict when the readers who sub- 
scribed with QBranch will get their issues.” 

As QL Today does not have names and addres- 
ses of readers who subscribe via QBranch we 
were unable to inform them directly. 

A fortnight after Jochen’s email QBranch had still 
not provided QL Today with the information requi- 
red and QL Today's editor posted a second email 


so 
| ee 


on the QL Users email group in somewhat stronger 


terms. This produced a reaction from QBranch: 
‘This is completely my fault - although Geoff 
has over-reacted as usual. | have had little time 
to read this list of late since, apart from my 
family, my job, my current position as Diving Of- 
ficer and instructor for Sussex Diving Club and 
my rock band, ! seem to have got involved in a 
political campaign to stop a big building deve- 
lopment in Brighton Marina. 

| was supposed to furnish Jochen with the num- 
ber of magazines | need for this current issue 
and | neglected to do so. Since then | have 
been so tied up in all these activities it has 
been push onto back brain. | apologise to those 
who subscribed for this oversight and | will 
rectify matters this week.” 

The editorial team of QL Today views the situa- 
tion with considerable dismay. Following the 
move to quarterly publication last year we have 
been able to build up a rhythm in the production 
of the magazine that has enabled us to keep to 
our promised publication schedules. The last is- 
sue was published on time and those readers 
who subscribe via Jochen Merz received their 
copies promptly. 

In a time when QL trading activity is rapidly declin- 
ing it is essential that the magazine retains a 
reputation for reliability. Although QL Today remains 
editorially viable, the editorial team are becoming 
increasingly concerned that the number of regular 
writers is now at the very minimum to ensure the 
magazine's medium and long term future. 

Over the years the readership pattern has 
changed and there are now roughly equal num- 
bers of continental and UK subscribers. The 
changing readership pattern and reduction of UK 
trading activity suggest that the present struc- 
ture of the magazine is no longer appropriate. 
QBranch expressed a wish to distribute the 
current volume, but QL Today will no longer make 
use of the UK office after that. All readers will 
then have a direct subscription to QL Today, 
During his association with QL Today Roy Wood 
has had a distinguished record of service to the 
magazine. Production of the magazine over 13 
years has not always been easy and during the 
difficult periods he had an infectious enthusiasm 
that gave others the encouragement to continue. 
The editorial team believes that without the con- 
tribution of Roy the magazine could have disap- 
peared many years ago. 


Website Review 

During the last few weeks there have been a 
number of changes to QL websites. some minor, 
some more important and some that raise inter- 
esting policy questions. QL Today begins this 
special news feature on websites by looking at 
Quanta subgroups. 

The 2004 demographic survey of Quanta mem- 
bership showed that Quanta membership was not 
distributed evenly over the UK but that there 
were clusters of members. The areas in which 
there was a cluster were uSually where there 
was or still is an active Quanta subgroup. At the 
moment Quanta has 8 subgroups. The most ac- 
tive are London, Manchester, Birmingham and 
Scotland. Two subgroups, Surrey and Sussex, 
were mainly known through the regular shows at 
Byfleet and Portslade but it is now uncertain how 
active they are. The remaining two are Dorset 
and Solent, but nothing is known of these, which 
raises the question whether they still exist in 
practice. 

Quanta’s webmaster, Dan Abott, has stated on 
several occasions that he would like to see the 
subgroups having an active role on Quanta’s 
main website but there has been little response 
from the groups themselves. Two subgroups 
SQLUG (Scotland) and London have their own 
website and both have reported changes in the 
last few weeks. 


SQLUG 

The main function of the SQLUG website 
(http://www.jms1.supanet.com) is for the downloading 
of software by George Gwilt and others. George 
has now reported a bit of bad news plus a solution: 
"The SQLUG website cannot now be updated. In 
order that programs for which | am responsible 
can be made available | have put some of the 
latest updates on the site at 
http://web.ukonline.co.uk/george.gwilt/ 


LONDON 

Malcolm Cadman has announced an update of 
the London subgroup website: 

‘The London QL and Quanta Group web page 
has been updated. 

A lot of new pictures of Quanta Workshops 
from recent years, have been added, as well as 
many minor changes. 
hitp://www.mcad.demon.co.uk/Iquan.htm 

| have also begun a new web page for "Retro 
Computing’, to list hardware, books, etc, that are 
available. 

http://www.mcad.demon.co.uk/retro1.htm 


London GL & QUANTA Greup 


The website is a page dedicated to the QL on 
Malcolm's general website. Although fairly short 
it contains a wealth of information and links. 
These include a short history of the QL and a 
small amount of software to download. There are 
also links to Rick Dickinson's Sinclair designs 
which were featured in QL Today a year ago. 
The retro page gives details of the QL books 
and hardware that the London subgroup has 
available for sale. 

This is a good example of a simple site publici- 
sing all the facilities a subgroup can offer Even a 
subgroup that did not wish to set up their own 
website could produce similar pages for the 
Quanta site. Will Manchester take up the chal 
lenge? 

Malcolm tells us that the London subgroup may 
organise a QL show next year No further shows 
are to be held in Byfleet or Portslade and should 
the show go ahead it will be the first Quanta 
show in the south for well over two years. 


QUANTA 

There have also been some changes on Quan- 
ta’s main website. (www.quanta.org.uk). Readers 
of the Quanta magazine will know that Dilwyn 
Jones, Quanta's newly appointed news editor, 
has already made his mark. Now some of his 
news items are being posted on Quanta's web- 
site. This could become a valuable resource for 
the whole QL community with up to date news 
without QL-ers having to wait until the magazines 


Current News 


are published. Dilwyn is also working hard to 
make Quanta’s helpline more relevant for mem- 
bers, but it is not known if this will eventually 
have a place on the website. 

Quanta has long had an aim to have public and 
members only areas of the website, but has yet 
to decide where the boundaries between the 
two should lie. This is a difficult decision for 
Quanta because there are several points of view 
with strong arguments for and against each. 
Some argue that Quanta members have paid a 
subscription so that large areas of the website 
should remain closed to non-members. The 
Chairman took this attitude in a conversation with 
QL Today at the Manchester show. 
A more intermediate view is that 
more content could be placed on 
the public area of the site, but only 
after it has first appeared in the 
Quanta Magazine. This would be 
fair to those members who do not 
have access to the internet. The 


On the home page of its website, Quanta makes 
the bold statement "We have close links with 
international groups.” Perhaps Quanta might like 
to name these groups together with the dates of 
the last contacts. 


Spanish QL & Spectrum Forum 

We have received the following news item via 
Quanta’s news editor: 

Javier Guerra writes: 

"We have a new url for the Spanish QForum: 
http://www.speccy.org/foro/viewforum.php?f=15 

The old forum had a lot of spam.” 


acting magazine editor is believed 
to support this point of view. 


The final view is that most informa- 


tion should be in the public area as 
a service to the whole QL com- 
munity. In this way Quanta would 
demonstrate its relevance to the future survival 
of the QL and thus might attract new members. 
In his Byts of Wood column in the last issue Roy 
Wood raised an interesting example of the pro- 
blems that Quanta faces in this respect. Roger 
Godley has been updating the Psion suite to 
make use of GD2 colours and his work is proba- 
bly the most important acquisition for the Quanta 
library in recent years. From the contact that QL 
Today had with Roger two years ago it was clear 
that he wanted Quanta to have the kudos for the 
project, but he would also like the software to be 
available to non members. It is strict Quanta poli- 
cy that its library is only available to members, 
but, given the author's strong wishes, is this a 
case for an exception? Should his work have a 
place on the public area of the Quanta website? 
In recent weeks there has been some effort to 
keep the Quanta website up to date although QL 
Today has had problems with out of date content 
on the website and in the Quanta Magazine. 
Quanta was slow in responding to our complaints 
in spite of the fact that similar problems occurred 
two years ago. QL Today believes that no adver- 
tising is better than out of date advertising and 
should these problems continue may be forced 
to review the current reciprocal agreement with 
Quanta. 


QL2K 

Jimmy Montesinos has made some changes to 
the help page of the QL2K website. He wrote 
that there had been some problems with the help 
page of QL2K. These were not problems with 
the QL2K itself, but with the website. 

He has now made several changes to the 
website to solve these problems. This was not 
easy to do as there was a complicated situation 
involving the internet supplier, hosting services, 
firewall, network, software, routing, referencing 
and so on. 

There were also severe demands on his time. 
Jimmy expects that he will make further small 
changes in the near future but there will be no 
major malfunctioning of the site. He is also think- 
ing of rebuilding the site to give it a more attrac- 
tive design. 

Jimmy has also given some advance information 
about the next release of the program. This will 
support 64 bits and Vista and will come in two 
editions, one for 32 bits and one for 64. There 
will also be some corrections to the sound sup- 
port under Vista. If time permits he also intends 
to test a new version of QLAYT. 

http://www. jadiam.org/QL 


Failed Forum 

In mid September Norman Dunbar set up an 
experimental forum on his website. In his own 
words: 

"I'm experimenting a little with 
http://qdosmsq.dunbar-it.co.uk 

and | have added a forum for discussion of all 
things QL, QDOS, SMSQ and so on. There's 
even an off topic area. 

At present, it is using over half of my allocated 
quota of disc, so it may not remain - it all de- 
pends. | can probably update my hosting ac- 
count to get more space if | must’ 

In practice this forum proved not be a success 
with just a handful of people registering. Early in 
November the forum was taken down. One 
registered user commented that he found most 
of his needs catered for by the QL-users email 
group and this appears to have been the general 
opinion. 

The QlL-users group has mellowed in recent 
years, but in the past there have sometimes been 
virulent differences of opinion and heated discus- 
sion that put some QL-ers off Prior to 2004 the 
then members of the Quanta committee ex- 
pressed considerable distaste for the group 
seeing it as being immature and puerile. In No- 
vember 2004 current chairman, John Mason, un- 
der the misapprehension that the Users group 
was a Quanta initiative, accused some of the 
users of abusing the ‘Quanta Committee's ‘Free- 
dom of Speech’ tolerance policy’ and threatened 
that Quanta could ‘invoke the constitution’ to 
redress this. 

Since that time Quanta’s attitude to the group 
has softened. John Gilpin was the first Quanta 
officer to actively participate and John Mason 
now maintains a watching brief Quanta’s web- 
master also monitors the group as part as his 
familiarisation with the QL community and this 
year an active participant in the group, Dilwyn 
Jones, has joined the Quanta committee. 

The failure of Norman Dunbar’s forum has wide 
reaching implications for Quanta as the organisa- 
tion has long expressed a desire to have a forum 
for its own members. It is now debatable whether 
there would be sufficient interest in a Quanta 
forum. 

Quanta has never made detailed plans for its fo- 
rum or of how this would be moderated. The or- 
ganisation has no tradition of encouraging vigo- 
rous debate and during the last year the present 
officers have shown a marked reluctance to 
allow disagreements and differences of opinion 
to be aired in the Quanta Magazine. When QL 
Today published an editorial that upset Quanta's 


chairman we offered Quanta a 2,000 word unedi- 
ted right of reply. Sadly this offer was not taken 
up. Quanta has failed to give both Tony Firshman 
and QL Today's editor a right of reply in the 
Quanta Magazine to misleading remarks made 
about them by Quanta’s officers. Quanta also 
failed to publish, give reasons for not publishing 
or even acknowledge a letter sent by email from 
the Birmingham subgroup giving their point of 
view about the misunderstanding that arose over 
last year’s Midlands show (see QL Today V12 i2 
p16). 


Software Section 
Once again Dilwyn Jones provides our software 
news: 


QL Font Editor 

This is a new pointer driven font editor program 
from Dilwyn Jones. It lets you specify font cha- 
racter range as well as use the mouse (or cursor 
keys) to edit the characters. It has facilities to 
bolden or italicise individual characters, handle fat 
(8 pixel wide) fonts for CSIZE 1,0 use, pan/scroll 
characters around the editing grid and to copy 
upper/lower case ranges if you wish to do so. 
The program was written in SBASIC using 
Easyptr 4 and compiled with QLiberator 3.36 to 
produce a program which runs on all WMAN2 
systems. Expanded memory is needed, as well 
as Toolkit 2. The program will run on SMSQ/E 
systems, or QDOS with pointer environment 
version 2 or later Several example fonts are 
supplied with the package. 

QL Font Editor can be downloaded from 
www.dilwyn.uk6.net/fonts/fonted2.zip 

It is a freeware program. 

Elsewhere in this issue we start a new series of 
articles on fonts written by Dilwyn. 
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GWASL Assembler v2.03 

The latest version of Gwasl assembler by 
George Gwilt is now available from Dilwyn Jones’ 
website. Gwasl is the Lite version of George's 
Gwass assembler, the main difference being that 


Gwasl is suited for use on 68008 processor sys- 
tems (i@. a standard QL and some emulators) 
whereas the full Gwass assembler is designed to 
use the additional instructions present on later 
680x0 systems. Gwasl is especially valuable for 
those following Norman Dunbar's Programming In 
Assembler series in QL Today magazine. 
Changes listed for recent versions include TABs 
can be used as well as SPACEs and the maxi- 
mum number of lines and labels is now configura- 
ble. 

The program and its source code files can be 
downloaded from: 

www.dilwyn.uk6.net/asm/index.html 

le O FB st 


Eile Lourich Utility MYOL Menu Jobs Help 


LEAR PCBCAD 

Malcolm Lear has excelled himself as this time 
we have two upgrades to his program. QL Today 
is still looking for a reader willing to review the 
software. 


VERSION 6.53 

Malcolm Lear has released v6.53 of his PCB Cad 
program, to include some important changes to 
bring back old QL compatibility. He's not had a 
QL for more than 10 years, so he is now started 
using the QL2K emulator to ensure correct QL 
Operation. It turns out that the GWASS assem- 
bler has been using 68040 instructions, so he 
has gone back to using the GST program. 

Here is a list of changes in version 6.53, taken 
from the REVISIONSIXT file in the package: 

NC text drill file shows drill sizes in both metric 
and imperial. SMD device notification in place- 
ment file. Using QL2K to check QL compatibility. 
68040 op codes removed. QL users may have 
had problems since 6.22. Moved back to GST 
assembler Memory allocation routines rewritten 


to be more QL friendly. QL’s must have full me- 
mory 768K expansion to run program. QL will not 
run any hi-colour commands. File loading pro- 
blems with QL2K which may well be emulator 
issues. 


VERSION 6.59 

Malcolm Lear released v6.59 of his PCB Cad 
program on 4th November 2008. This version 
has now added the facility to draw circles and 
ellipses. The program has been updated several 
times recently, so here's a list of major changes in 
recent versions of the program, taken from the 
REVISIONS_TXT file supplied with the program: 
6.56 02-10-08 Logical layer mode bug in dot 
matrix layer selection fixed. Cadtk.bin and 
Printerbin merged to save memory, All auto- 
mated file format updating now done in as- 
sembler. File loader now removes duplicate 
information blocks. 

Mode 8 graphics aspect ratio back to pre 
6.22 while retaining changes needed for fu- 
ture pointer environment version. This pro- 
duces much cleaner diagonals and gives 
the impression of higher resolution. Screen 
mode toggle now disabled when hi-colour 
drivers detected. More dot matrix issues 
resolved. Invisible pads and blocks layers in 
logical layer mode are now invisible. 


6.57 


6.58 Element stats at bottom left of screen now 
include layer information. Grid step and 
scale updated when component picked up 
or dropped. 

04-11-08 Circle and ellipses can now be 
drawn using tracks. Extension names 
changed to match style use in the SBasic 
program. 


6.59 


TURBOPTR 

George Gwilt writes: 

Remarks by Dilwyn Jones at the last QUANTA 
AGM (thanks Dilwyn) caused me to make 
TurboPTR more user-friendly. The result is now 
available at 

http://web.ukonline.co.uk/george.gwilt/ 


Goodbye Eindhoven? 

A long-standing QL tradition may have come to 
an end when the last show of 2008 was held at 
the St. Joris College in Eindhoven in October. No 
other show location has been used for QL 
events so long and so frequently. 

A full report appears elsewhere in this issue. 


Second Thoughts 

some users are having doubts about the 
suitability of the Asus eeePC for QL use. Per 
Witte reported on the QL Users email group: 
"After using the eeePC 701 for a while, | gave it 
up as too limiting for my purposes. The battery 
life is crap, the fan whirrs incessantly because 
the thing produces far too much heat. It also 
seems stupid to put up with a 7” screen when 
the box is more like 10. 

Richard Kilpatrick responded: 

‘| agree that the 701 is too limiting; this is why | 
favour the Acer Aspire with 120GB HD. It's 
£229, so still well within the cheap end of the 
spectrum (compared to £300+ for the 901/MSI 


Wind) and is very small and efficient. 

Do try one. The 1024 x 600 resolution over the 
Eee 701's 800 x 480 is a massive advantage.’ 
In the last issue Jochen Merz confirmed that 
QPC runs well on the Asus Wind. 


Rewriting History 

It is a myth that the QL is a Sinclair product. In 
fact the first QL was produced in 1909 long be- 
fore Sir Clive was born. We are not sure what 
was used for a display because televisions and 
monitors had not been invented, but you know 
the QL is almost 100 years old because you read 
it in QL Today. 

Red faces all around the QL Today editorial office 
as two eagle eyed proof readers failed to notice 
a missing word in an editorial that made the QL 
four times older than it is. We said that 2009 was 
the QL’s centenary when we meant its quarter 
centenary. 

Quanta has announced some details of its 
quarter centenary celebration to be held next 
year. The venue is the Allesley Hotel, which is 
about 3 miles north of Coventry city centre. 

The event will be held on Saturday 18th and 
Sunday 19th April. Quanta is promising a program 
of talks, an interactive problem solving workshop, 
a repair desk and traders. There will be a 
celebratory dinner on the Saturday evening and 
the Annual General Meeting on the Sunday. 

One person who will not be attending is Tony 
Firshman who has a prior singing engagement in 
Venice (moonlighting as a gondolier?). Geoff 
Wicks has also announced that he will not be 
playing an active part in the show, nor will he set 
up a Just Words! table: 

"Quanta cannot have it both ways. They cannot 
criticise me in the Quanta Magazine, fail to offer 
a right of reply and then expect me to work for 
them. Also Quanta showed a lack of gratitude 
for the work | did to ensure the success of the 
Solihull show last year The chairman pointedly 
omitted me from the list of people he publicly 
thanked, which | find to be unbelievably mean 
spirited” 

An activity over which there is a question mark is 
some form of internet connection. A Skype con- 
nection was used at the Italian show for a pre- 
sentation on QemuLator, but nothing of this type 
has ever been attempted at a UK show. Dilwyn 
Jones is known to be actively investigating how 
Skype could be used by Quanta in both shows 
and elsewhere. However the hotel has only limi- 
ted internet facilities. 

QL Today has some bad news for drivers who 


needed a subsidy of about £25 per car for AA 
sign posting to find their way to QL is 21 in Ports- 
mouth. The Allesley is even more difficult to find 
and there is a nasty roundabout to negotiate just 
before the hotel. As far as QL Today could see 
there are no signposts for the hotel itself, How- 
ever once you are in Birmingham Road you can- 
not miss the Allesley as our photo of the en- 
trance shows. Motorists are advised to avoid the 
centre of Coventry if possible as the inner ring 
road is small but can be confusing. 


Neither Quanta nor the hotel can provide advice 
for public transport users, but QL Today can. A 
bus stop to Coventry is directly opposite the 
hotel entrance and the bus stop from Coventry 
about 20 yards up the road. The service is fairly 
regular and the stops are serviced by buses 7 
(not Sunday), 75 and 900. However in Coventry 
city centre you are on your own. Even QL Today 
could not trace the nearest bus stops to the rail- 
way Station for these services. 

We advise you to try the website: 
www.travelcoventry.co.uk/bus/index.asp 

This gives details of bus timetables and they are 
promising maps of the bus stops before long. 


QUANTA Crisis 

It is not only QL Today that has had problems get- 
ting its magazine to the readers on time. The 
June/July Quanta Magazine was published at the 
end of August and since then there has been no 
further issue. A formal announcement from Quanta 
on the QL users email group explains the situation: 
"Due to not receiving any response to commu- 
nications sent to our new Magazine Editor - 
Tony Hill - over a now considerable period, this 
committee have asked John Gilpin - QUANTA 
Treasurer and Membership Secretary - to stand 
in again as Joint Magazine editor until (at least) 
the AGM in April 2009. The other Joint Editor's 
position will remain with John Mason. 

In order to notify you all of details for the forth- 
coming Celebration Workshop and AGM in April 
2009, John G has agreed to publish Quanta Ma- 
gazines for August/September/October 2008, (a 
three month's issue), and November/December 
2008Nanuary 2009 (another three month's 
issue). This will bring us up to the end of Volume 
25. He has also agreed to publish a Magazine 
for February/March 2009 which will be our 
"Celebration Issue” - QUANTA will be 25 years 
old in February 2009." 

Behind this statement is a human story that QL 
Today discovered when some of our emails to 
John Gilpin bounced back. In addition to Quanta 
problems John has had similar problems with the 
scout movement when he had to suddenly take 
back duties that he had passed on to someone 
else. To add to his problems his internet server 
made a mess of upgrading his broadband with 
among other things emails going astray. 

To use a Dutch phrase John is "Having to mop up 
with the tap still running’. 

John Gilpin is the linchpin of Quanta and without 
him Quanta would probably cease to function. His 
duties as treasurer require some knowledge of 
accountancy and as acting Newsletter Editor a 
complete familiarity with Page Plus. In a sense he 
is ifreplaceable unless someone else has or is 
prepared to learn these skills. Through his active 
presence on the QL Users email group John 
Gilpin has become the human face of Quanta to 
whom many first turn to for help in Quanta 
matters. 

In John's own words: 

‘The situation seems to be ongoing and if 
QUANTA Members are to receive their Maga- 
zines on time and of a reasonable quality, a new 
Magazine Editor MUST BE FOUND by April 
2009 as | cannot guarantee my time to continue 
to do this job after that date.” 


One of the most liberating things | have come 
across is QPC Print. The other is of course 
QPC2. All the old dot matrix printers | used in the 
past with various QLs ranging from Super Gold 
Card to a Q60 have given up the ghost. Since | 
use Archive and Perfection for printing, the 
demise of the old printers was a severe blow ... 
until QPC Print came along. 


Pound Sign and Hash 

Perhaps you remember the days when articles 
would appear with © being printed instead of +. 
Eventually most people found out that it was a 
good idea to print using some sort of editor 
which had a printer driver In this the instruction 
was set to replace , (CHR$(96), by the instruction 
to the printer to use the UK character set 
followed by the code for #, CHR$(35), followed 
by a return to the 
US code. A hash 
was simply sent 


OPC PRINT CHARACTERS 


contents of wine racks. As a check on the accu- 
racy of the record | used a second program 
which printed a representation of each rack. Each 
of the spaces contained either a blank or a cha- 
racter depending on whether the record showed 
that space containing a bottle or not. By compa- 
ring the representation with reality | was able to 
detect, and so correct, anomalies. 

The grid representing a wine rack was made up 
of eleven characters available as special gra- 
phics characters on my Epson printers. The cha- 
racters were: 

A horizontal line bisecting the character rectan- 
gle. A vertical line bisecting the character rectan- 
gle. Four corners each with the point in the cen- 
tre of the character rectangle and isolating a 
quarter of it. The five distinct figures produced 
from the corners 
taken in pairs. 

As an example 


as itself. SHER rhea ig}? three lines each 
in the days when 129 17 Mg 215 1 of three charac: 
| used to send me Sipe, seo ters suffices to 
output directly to 132 i 175 * 218 i produce a boxed 
the printer | used ae : pb : a3 - character The 
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tion facility to ee. ' 78 | eos ~ left corner, then a 
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i 149 é 192 in 235 U i j 
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How nice it 1st a 194 - 237 ¥ left corner a 
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to the printer for 136 f £99 A 42 = 
157 B 200 E 245 % 
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Some time ago | 165 N 208 5 251 1 discover that dda 
£6 , 209 B 252 , 
wrote a program jes : bee Fs Man » fer output from 
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keep track of the 169 ® 212 E 255 Archive was ac- 
170 “ 213 i cepted easily by 


QPC Print. All) that is, except certain special 
characters, including the box elements. | had 
laboriously re-written my Archive box program to 
produce boxes made up of (| think) plus signs. 
The result was usable but nasty. It then suddenly 
Struck me (meaning that my subconscious, which 
had been mulling over the problem at leisure, 
eventually decided to alert my consciousness 
and tell it..) that you could send character values 
128 to 255 to QPC Print and have real characters 
printing. Investigation showed that the eleven 
box characters are included. They have values 
179, 180, 191 to 197 inclusive, 217 and 218. 

This means that | can produce my boxes via 


items about resizing windows in the last QL 
Today, here are some hints and a listing to show 
a simple way to make window resizing behave a 
bit more predictably in Easyptr 4. 

It might work in earlier versions of Easyptr, using 
Per Witte’s resizing routines from his Knoware 
website (not tried). 

Many of my early programs written using Easyptr 
4 managed to resize windows, but the new origin 
position was very hard to 
predict because, as was 
said, PE routines do not 
guarantee menus will 
reappear at the required 
point. Resizing was a bit 
random - you never really 
knew where the new size 
menu would appear when 
drawn. 

This demonstration rou- 
tine written in SBASIC 
seeks to provide a little 
routine that behaves 
rather better than a simple 
resize might achieve, by 
reading window sizes and 
origins before the resize, 
so we can cheat a little 
and adjust the results to 
compensate. 


First, we need to design a 
small menu window_ in 
Easymenu 4. This has just 
three loose items, 
numbered ~-1, -2 and -3: 


In response to George Gwilt and Jochen Merz's 


Archive using QPC Print. | may say that the alte- 
ration to my original program to achieve this was 
pretty easy. 

| also altered Perfection's printer driver so that it 
would be possible to put into a document many 
of the special characters in the QL fonts and also 
have them printed via QPC Print. One example of 
this is the greek lower case beta. In particular the 
pound sign has value 156 in QPC Print. 

| could describe the remaining 117 characters in 
the range 128 to 255 which QPC Print produces, 
but it would be a lenghty task and not very 
useful. Instead | show the characters in a table on 
the previous page. 


sate 


-1 is the top left corner MOVE icon 
-2 is the RESIZE icon next to it 
-3 is a simple ESC item to quit from the program. 


Make sure that once you have designed the 
window, that you set the scale flag (see figure 1) 
values to 4 each for width and height, and 0 each 
for x and y origin. 


Figure 1 - Settin 


Scale Flags 


LEE 


Next, add the three loose items as shown in 
figure 1. I've used the system icons for MOVE and 
RESIZE, the double box symbols, although you 
can design your own if you wish. 

It is important that the top left corner icon is 
loose item -1, that the next is loose item -2, and 
the Esc icon at the top right is loose item -3 to 
match what the example listing expects. 

When it comes to assigning key presses to the 


Listing 1 -— Resizer_bas 


100 MDRAW #0,"flp1_resizer_men" 
110 REPeat program 


loose item, set ASCII code 5 or 245 (CTRL F4) 
for the MOVE item, 6 or 241 (CTRL F3) for 
RESIZE and 27 for the Esc item. 5 and 6 are 
‘internal’ system codes, while 241 and 245 are 
Standard keypress ASCII codes. 


Then, once you have saved the menu with the 
name ‘resizer’, you can type in and run the 
following program: 


: PVAL #0,pr% : REMark get pointer request details before 


WSIZE #0,xv%,yv% : REMark call resizing routine, get x and y variation 


MDRAW #0,"flp1_resizer_men", pr%(10) ,pr%(11) ,xsize%, ysize% 


120 num = MCALL(#0) 
130 SELect ON num 
140 =-1 : WMOV #0,-1 : REMark Move 
150 =-2 : REMark Resize 
160 DIM pr%(16) 
resize in array pr%() 
170 
180 MCLEAR #0 : REMark clear old menu 
190 REMark new size 
200 xsize% = pr%(8) + xv% : REMark vary horizontal size 
210 ysize% = prZ2(9) + yv% : REMark vary vertical size 
220 
230 =~3 : EXIT program : REMark Esc 
240 END SELect 
250 stat% = MSTAT%(#0,num TO 0) 


260 END REPeat program 


: REMark reset loose item status 


270 MCLEAR #0 : INK #0,7 : REMark reset after use 


You should find that as you click on the second 
loose item (RESIZE) the code in lines 150 to 220 
take care of resizing and redrawing the menu, 
with the origin locked at the same position as 
before the resize where possible. 


Line 100 draws the menu initially 
Line 120 calls the menu reading routine MCALL. 


Line 140 handles the MOVE routine. Note that if 
you set a key code of 5 for MOVE, this is 
handled internally and this command is never 
called. WMOV #0.-1 is a special version of 
WMOV that handles MOVE calls in Window 
Manager 2. 


Line 160 is the “brains” behind the resizing. the 
PVAL command does a read of the window de- 
tails before the call to resize. In other words, it 
stores the origin and dimensions of the window 
before the resizing, so that we can use this to fix 
the origin after setting the resize. 


PVAL returns a 16 element array, as described 
under the PVAL entry in the Easyptr manual. The 


elements of pr%() we are interested in are: 
pr%(8) window width 

pr%(9) window height 

pr%(10) window x-origin 

pr%(i1) window y-origin 


Line 170 calls the WSIZE command, a new 
command in version 4 of Easyptr It takes 3 
parameters, a channel number, and two variables 
which return the variation or change in size of 
the menu after resizing. In other words, if it was 
200 pixels wide beforehand, 300 pixels after 
resizing, xv% would contain 100 after the call. 


After resizing, the MCLEAR statement in line 180 
clears the old menu size ready for it to be 
redrawn in the new size. 


Lines 200 and 210 work out the new size of the 
menu by adding the change in size to the original 
size. 


Line 220 draws the menu in the new size. Note 
that this time we use the extended version of the 
MDRAW command which allows size and 
location details to be specified: 


MDRAW #channel,menu_name,x_position, 
y_position,xsize,ysize 


We use pr%(i0) for x_position and pr%(11) for 
y_position so that the menu's origin stays in the 
same position where possible (unless the new 
size means the menu falls outside the visible 
screen, in which case details may be automatical- 
ly adjusted by the system). 


Two difficult questions to test 
knowledge: 

1) Quanta has always been the largest QL 
user group, but which land hosted the 
second largest group, being at its peek 
1,200 strong? 

2) How come that user group did not have a 
single member? 

| doubt if many people would get the first ques- 
tion right. The correct answer is the Netherlands 
and Stichting Sin_QL_Air, although other lands 
might like to challenge this. You may have 
guessed the second question is a trick one, 
because to answer it you would need a know- 
ledge of Dutch law. 

The Dutch have two forms of organisation a 
"stichting” and a ‘vereniging’. The latter has a 
tighter legal structure and members. The former 
has a looser legal structure and no members. Its 
supporters are known as donors. 

| was a Sin_QL_Air donor from 1989 to 1996, but 
even | was surprised to learn from Sjef van de 
Molengraaf that at one time there were 1,200 
donors. Given that Quanta had about 2,000 
members at its peak and that the Netherlands 
has a population a quarter that of the UK, the 
Netherlands can probably claim, per capita, to 
have been the most QL friendly land. 

Sin-QL_Air and Quanta are the only active user 
groups still in existence. In recent years 
Sin_QL_Air has hosted three shows a year in 
Eindhoven, but this could shortly change. 

The Dutch have always played an active role in 
the QL community. Formerly they held 6 shows a 
year, one of which was an international event that 
was a “must” for anyone who was anyone in the 
QL community. Shows have become less fre- 
quent and international shows smaller over the 
years, but in 2004 Sin_QL_Air hosted the most 
significant international QL event in the last 10 
years. This brought most of the QL developers 
together and gave a boost to what was then a 


your 


QL 


xsize% and ysize% have been adjusted by now to 
specify the new menu size. 


Line 230 detects the ESC keypress and jumps 
out of the loop called ‘program’, and the 
MCLEAR statement in line 270 removes the menu 
as the program stops. 


flagging QL community. To remind you of that 
event we print a picture of the after-show dinner 
taken by Tony Firshman on the cover. 

One Sin_QL_Air donor, Wolfgang Uhlig, wrote a 
great deal of software for the QL. His first pro- 
gram was a commercial database, SuQcess and 
he then wrote a number of freeware tools to as- 
sist QL programmers in using GD2 colours. When 
Wolfgang lost interest in the QL, Bob Spelten 
took over his work and his updates of the pro- 
grams regularly feature in QL Today's news 
pages. 

Bob works for an international computer compa- 
ny and by coincidence when | first lived in the 
Netherlands and was still learning Dutch, | worked 
for two and a half years in the Transport Depart- 
ment of the same company. | gained two things 
from this work. The first was learning to drive a 
fork lift truck but the second is more dubious. 
Like most native UK English speakers | speak 
Dutch with a heavy accent, but the experts tell 
me | speak some words with a pronounced 
coarse Amsterdam working class accent. 

It was while | was at the company that a revolu- 
tionary new product was launched called a 
"wordprocessor’. We even set up a special room 
to demonstrate it to potential customers. Strange- 
ly it had a screen in A4 portrait format and in 
place of the then usual green text on a black 
background had black text on a white back- 
ground. No doubt this was done to help a com- 
puter phobic secretary think it was still a sheet of 
paper. 

| cast jealous eyes on the product thinking ‘I 
wouldn't mind one of those’. The Head of 
Supplies noted my keen interest and _ strictly 
forbade me to touch it. Little did he or | know that 
within four years | would own a wordprocessor 
more in my price bracket. It was called Tasword 
Two and ran on a Spectrum. 


Just a few years further on and Sin_QL_Air 
would come into being with regular shows held at 
the St. Joris College in Eindhoven. 

The first QL meeting in the Netherlands was held 
in the Summer of 1984, and it is a little known fact 
that there have been two Sin_QL_Airs. The first 
formally came into being in March 1986 and was 
closed on ist April 1992. The second was formed 
just two days later. 
Sin_QL_Air was 
an active user 
group and took 


Stichting voor Sinclair QL Gebruikers: 


ties. Since then a second new head has come to 
the school and he is now reluctant to allow 
Sin_QL_Air to meet on the premises. 

Sin_QL_Air now has a difficult choice to make. 
One possibility is to meet at a more central loca- 
tion such as Utrecht, but this will mean hiring a 
hall at commercial rates. Would the numbers at- 
tending justify this? One advantage of the 
Netherlands is that it is within easy reach of se- 


part in what was 
then the Nether- 
lands most impor- 
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2 a for international 
‘ ' shows, but is there 
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QL2004 was a 
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great success, but 


puter show held 
in one of Amster- 
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bition halls. It was 
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Goeckope, mteme 512K-utbreiding, 
Universele diskintetface, 


Printjes, 
| Gl-onderdelen. 


Today's query about 
a possible continen- 


REPARATIES 


a recruiting po- 


tal celebration of the 


ster used at the 


1987 fair The or- wm 
ganisation also 
had its own ma- i CARTRIDGEIDISKETTE-SERVICE 
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ceased _ publica- 
tion in 1997 be- 
cause of a lack of 
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QL's quarter cente- 
nary next year. 

The other possibility 
is for the orga- 
nisation to be 
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wound up, but here 
there is also a com- 
plication. Like Quan- 
ta, Sin-QL_Air has 
built up a large 


copy. In recent 


years no dona- | 
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tions from sup- - 
porters have = 
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as the cost of 
running the 
shows was low. 

No location has been used by QL-ers for so long 
or so frequently as the St. Joris College, but all 
good things must come to an end. 

The school was used because two QL-ers, Sjef 
van de Molengraaf and Karl Boekema worked 
there. They were allowed to use the main hall 
free of charge together with many of the 
schools facilities. Sjef retired 6 years ago and 
slowly he has become a lesser known figure as 
new staff have been appointed. There was a 
warning on the wall at the time of QL2004 when 
a new school head allowed us to use the school, 
but not its computer projectors or internet facili- 


days when it was a 
much larger organi- 
sation. If Sin-QL_Air 
is wound up its con- 
Stitution states that 
the money has to be used for the development 
of the QL. This is more difficult than you might 
think. 

When Sin_QL_Air met at Eindhoven for the last 
time this year we were banished from the main 
hall because a group was meeting there who 
had paid for it. It was a small group that gathered 
there and | was only able to make it for the last 
hour. It was, however, an international group with 
representatives from the Netherlands, Belgium, 
Germany and the UK. 

Eindhoven may soon be no more, but fond me- 
mories of it will remain not only in the Nether- 
lands but in many other countries. 
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A few impressions from the last meeting at 
Eindhoven (not in the main hall), October 2008 


Postscript for Non-UK Readers: 
We would welcome more contribu- 
tions from our non-UK readers. Re- 
member that the editor knows first 
hand how difficult it can be to 
write something in a language that 
is not your native tongue. | shall be 
more than happy to improve and 
rewrite a text and then send you a 
copy of the revised version for 
your approval. 

One of my greatest achievements 
in the Netherlands was to have an 
article published in a_ national 
newspaper Late in the afternoon 
the day before | was telephoned 
to give permission for small chan- 
ges to be made to improve the Dutch. Much to my surprise the next day | discovered my article was 
being used as background to their lead news story and was advertised on the front page. 

| was glad | dared to write it and thankful for the changes that were made. 


Some time ago, | wrote about the Config pro- 
grams and the use of Configuration blocks. In this 
article | intend to look at several free utility pro- 
grams you can get for creating configuration 
blocks and compare them to see which might be 
best for your needs. 


Ewald Ikeman, Dilwyn Jones and Rich 
Mellor. 

Q-Config - a more recent and significantly 
enhanced version of Basconfig from Rich 
Mellor. 


The programs I'll be looking at are: sine oe alee tai 


Basconfig - the original program from Oliver a _ 
Fink, later updated by Norman Dunbar ee eee et ee ee 


What Is A Config Block? 


It's a system whereby you can include data telling 
a program how to start up - the data could be a 
default drive, for example, or the name of the 
directory where the program lives and finds its 
files, the colour of ink or paper the program uses 
to display itself on the screen, whether the pro- 
gram turns sounds such as error message tones 
off or on and so on. 

This data is built into the code of the program 
and includes a list of options which are available 
to you. It is structured in a standard format, which 
allows a program such as Config or Jochen 
Merz's Menuconfig program to ask you what to 
change and to alter this data in the program, so 
that the next time you start the program, it will 
use the startup default values you have set. 
When a program like Config asks you questions 
to change the values of these startup defaults, it 
actually patches the executable program itself to 
make these changes ‘permanent’. 


Uindow origin, 

[Uindow origin, Y-coordinate) B 

Position window at pointer (Overrides uindow origin)> Gn 
Flashing cursor? 06 

Configure XCHANGE defaults version 3.9L (Y, N or ESO)> ¥ 
Default memory allocation <kBytes)> £28 


Figure 1: The Config program, configuring Xchange 


It is one thing to insert these bits of data into a 
program and to change them with another pro- 
gram. Your program must itself be able to read 
this information. Most utilities to create configura- 
tion blocks provide some mechanism such as 
basic extensions for the program to be able to 
read these bits of data. Bear in mind that there 
are several types of data which can be included 
in Config blocks, such as strings, 3 lengths of 
integer (byte, word, long word), character, code 
and select. There are also two levels of Config 
data, known as Level 1 (the older type, which is 
simpler to handle) and Level 2 (a more recent 
development which although harder to program, 
provides additional facilities). 


Where To Get These Programs 
| got copies of all of mine from Dilwyn Jones's 


website, though they are all freeware or PD, so 
you should be able to get copies from PD 
libraries and CD compilations too as well as most 
websites offering free QL software, such as 
Thierry Godefroy’s website 

Thierry Godefroy: http://qdos.dyns.net/ 

Dilwyn Jones: http://www.dilwyn.uk.net/index.htm| 


Basconfig 

This was the original program by Oliver Fink of 
QLaboratories in Germany many years ago. Al- 
though Oliver no longer updates this particular 
original version, it has been updated by several 
people since, with some bug fixes and additional 
facilities included along the way. It asks you a 
succession of questions such as how many 
items to include, what data type you require, 
ranges for the data (e.g. string lengths or limits on 
number values), what prompts to use and so on. 
This is then bolted onto the end of a set of basic 
extensions to return the data to the program as 
Strings, integers, code values etc. This data block 
can then be LRESPR’ed for use while developing 
an interpreted basic program, and included in a 
compiled program with a $$asmb directive for 
QLiberator compiled programs, or a %% directive 
for Turbo compiled program. Basconfig can only 
create config blocks for interpreted or compiled 
SuperBasic or SBasic programs, it can't create 
blocks for assembler or C programs. 

While this is pretty easy to do, it can be time 
consuming and you have to make sure you get it 
right first time, because Basconfig cannot edit its 
own config blocks once saved. Not a problem 
for simple one or two item blocks, which are 
easy enough to redo from scratch, but a bit of a 
chore for a larger config block with many items. 
When you get a copy of Basconfig, make sure 
you get a fairly recent version and also note that 
somewhere among all the updates to the pro- 
gram, the version numbers got a bit out of se- 
quence between authors. Versions 1.12, 112a and 
1.13 all seem OK and have their own particular 
features and issues. Most of these versions have 
extensions to return the program name and 
version number from the config block, as well as 
long word type handling which Oliver's original 
version did not. You can see what changes were 
made in which version by reading the Quill docu- 
ment called bsconfig_doc which is part of the 
package. Most versions of Basconfig seem to 
include the source code, so you could if you 
needed to modify it to fix bugs or add more 
facilities. 


The main parts of Basconfig are: 

e Basconfig_obj or _rtm - the main part of 
the program, which guides you through the 
process and generates the finished config 
block. In most versions, it looks like the 
Config program itself 

e Cfg_bin - this is the core of a configuration 
block, with extensions such as C_STRG$, 
C_CODE and C_WORD to return data. 
When the main program has finished 
asking you to enter details, it loads Cfg_bin 
and adds the config block to the end of 
this, then offers to save it and you have to 
type in a suitable filename for where to 
save It. 

e Bsconfig_doc - the instructions 

You also get source files which include 
basconfig_bas (uncompiled program), chbase_rext 
(an extension used by the program), 
basconfig_cfg (the program's own config block - 
yes, you can configure basconfig with config, just 
to confuse you) and cfg_asm (the assembler 
source for the program's basic extensions). 
Figure 2 shows the program in action. | was using 
vi13 of the program for this, other versions may 
look slightly different. The first thing you have to 
enter is the number of items required, so you 
should plan this carefully beforehand for two 
reasons - you have to specify the number of 
items in advance plus you should keep a written 
record of the config block details in case you 
need to recreate it from scratch later on since 
oe can't edit blocks it has created. 


S nif Fig Extensions | Level 1 = = 
This gram, supplied by GLaborator ies, ishernrnl a file that 
allovs. the u use of the standard QJump Conf ‘guration program in 
conjunction with O Liberated SuperBASIC progrom: 

}Bug fix & LONG WORD handling by Norman Dunbar, Sth Apri{ 1994. 
C_VERSS, C_NAMES extensions by Diluyn Jones, 2nd October 1995. 


Larger BasConfig display by Ditwyn Jones, 16th February 1999. 


Enter the total number of aon items required for 


your file or press ESC to quit 

pEnter softvare none? Davids Prigran 
Enter software version> 1288 

‘Select type for item #1> Sieg 

Type selection keystroke for tha item> A 
Enter maximum length of the string> 62 


Figure 2: Basconfig display. 


Next, you need to enter a version number and 
name for your program. Version numbers usually 
start at 1.00, and may be up to 8 digits long in 
this version. This allows the 3-part version num- 
bers along the lines of 
main_version.sub_versionrelease_number e.g. 
12.34.56 The details are of course up to you. The 
program name can be up to 25 characters long 


and should usually be a meaningful name such as 

the name under which you distribute your pro- 

gram. 

Next, for each item, it asks which data type you 

require. It starts with String type, but by pressing 

the space bar you can change it to other op- 
tions: 

String - strings, which can include filenames. 
Some versions allow strings to be explicitly 
specified as a normal string, a filename, a 
directory, or a filename extension. Not all 
versions of Config can correctly and fully 
handle all of these. 

Char - character, a single character or keypress. 

Code - a number and an associated string, such 
as O=No and 1=Yes 

Select - this type is not supported in this ver- 
sion. 

Byte - a byte (8 bit, 0-255) value 

Word - a 16 bit unsigned value from 0 to 65535 

Long - a 32 bit long word value from 0 to 
2.147483e9 or 2 31. 


Once you have selected the type, you have to 
assign a selection key. While this is ignored by 
some versions of Config and Menu Config, you 
have to specify it because some configuration 
programs list all the options preceded by a selec- 
tion key, so it is important to specify one to en- 
sure each item can be uniquely selected, but it is 
not the end of the world if you duplicate selection 
keys. | usually assign A to the first one, B to the 
second and so on, but this is of course up to you. 
Next you are asked for item range in most cases, 
e.g. if the item is a string, it asks for the maximum 
length, A good example here is filenames - 
QDOS and SMSQ allow these to be up to 36 
characters long, or up to 41 characters if you in- 
Clude drive names, so for filenames you might 
enter 41 (or 42 in fact, as it is usually better to 
make strings an even number length). For charac- 
ters, it asks for the default character, the value it 
takes until you later modify it with Config. It then 
asks for a description of the item - this is the 
prompt or question Config displays for this item 
when you configure the program, e.g. "Enter de- 
fault filename ", without the quotes of course. Be 
a little bit careful about when you press Esc to 
finish the entry, as you need to be aware how 
many times to press Enter to control whether 
any input is on the same line as the prompt, or on 
a new line, or even with a blank line in between. 
Description or prompt entries can span several 
lines of text if you wish, although it is usually best 
to keep them as short and informative as possi- 


Kaiser-Wilh.-Str. 302 D-47169 Duisburg 
http://SMSQ.J-M-S.com SMSQ@J-M-S.com 


NEW! QMENU Version 8! NEW! 


It has taken a long time ... but here it is: QN4ENU Version 8 and The Menu Extension Version 8 
Most Pointer Environment users already know it: the Menu Extension. It is an interface which provides 
ready-made menus like file-selector boxes, simple-choice-menus or select from a list. QMENU is a 
guideline how to use it from BASIC, Machine code or maybe other programming languages which allow 
Machine code interfaces. It explains how to use it with various examples in BASIC and Machine code. 
You are allowed to use it in your own programs and you may even sell it under license. The Menu 
Extension also contains the Scrap Extension (“clipboard). 
Multi-column menus, file-select with tree and view option, Filelnfo Il support - just the FileSelect menu 
on its own is a beatiful extension to your system. 
QMENU has not been advertised for quite a while, as the last version 7 manual was not updated in the 
past few years, while the Menu Extension itself got updated here and there. However, many updates in 
the Menu Extension and several user inquiries made me think about releasing an updated version of 
QMENU. The manual has been completely revised and reflects all the minor and major changes and 
add-ons: from the assembler-side, from the BASIC programming side, and also from the user's side. You 
get a 42-page printed manual, a floppy disk with updates keys, updated help texts for QD Hyperhelp and 
updated and new examples. 
Please note: The Menu Extension from version 7.65 onwards works only under SMSO/E V2 (e.g. QPC2 
or systems with high-colour screen drivers). If you run the “old” QL Pointer Environment, you should 
stick to your old Menu Extension. English only (a German version of MENU__rext is also on the disc, but 
no German documentation). 

Some of the changes since version 7.04 (the last “officially” documented one) are: 
DSEL (Directory Select) allows up to 10 devices 

RSTR (Read String) has additional parameters (which force the values entered to be ints, floats, not 
empty, disables ESC etc.) It can also be used to enter hidden passwords. 
Timeout feature has been added to RPER (Report Error) and ITSL (Item Select). 
Some menus have got a MOVE facility. 
New menu SYSS (System select) provides fast selection of items from the Hotkey buffer history, 
currently running jobs, Things in your system, Executable Things in your system). Just one call and the 
System Select procedure collects all the information for you and provides it in a list - very easy selection 
Hotkey buffer history now available in the file-select instead of cycling through the “previous” ones 
All this, bug fixes and more - available NOW. 

To order, please send letter, fax or E-Mail or place an order through the secure order form on 
SMSQ.J-M-S.com (you will find screenshots on the website too). Prices (all in EUR): 

If you do not own an old version of QMENU 24.90 + 5.- postage. 

lf you already own QMENU (Version 7 or before): 17.90 + 5.- postage. 

Special offer: For OL Today subscribers only: QMENU (Update or new): 14.90 + 5.- postage. 


We accept VISA, MasterCard & Diners Club online and offline! Amex only by mail or fax, not email! 
New payment methods for our customers: Money transfer to “local” account in many countries! 
e Deutschland: Jochen Merz, Account 493 50 431, Postbank Essen, BLZ 360 100 43 
e Osterreich: Jochen Merz, Account 85055317, PSK Wien, BLZ 60000 
¢ Switzerland: Jochen Merz, Account 60-690080-4, PostFinance, Clearing-Nr. 09000 
e The Netherlands: Jochen Merz, Gironummer 3258439, Postbank NL Amsterdam 
¢ and from all other countries in EUR with IBAN and BIC to account 
Jochen Merz, Deutsche Postbank AG, IBAN: DE21 3601 0043 0611 1004 37 / BIC: PBNKDEFF 360 
e UK customers can pay in £ (convert EUR prices above to £ by multiplying with 0.86) to 
Jochen Merz, Account 83795395, Citibank UK, Sort code 30-00-45 
or send cheques in £ - no ie for UK sterling cheques! yadle e 10 
e US customers can pay in US$ (convert EUR prices above to US$ g pay 
by multiplying with 1.32) - no fee for US cheques in USS! nea? ea ue ae id teehee ai 


ble. Be aware, for example, that if strings can be 
up to 62 characters long, they should be input on 
a separate line. as there won't be room for a 
prompt and a long input on a single line, and 
inputs can't normally straddle 2 or more lines. 
When using the Char type, you can specify ran- 
ges of characters which can be allowed, eg. di- 
gits, upper case letters, lower case, other print- 
able characters, and cursor characters. This al 
lows Config to limit the characters which may be 
pressed, e.g. letters only. 

Code ts a difficult type to master until you get 
used to it. It lets you specify a few values such 
as 0 for No and 1 for Yes, but to make it easier 
Config displays a short text for each value, while 
the extensions return the code value so that 
your program can do a simple SELECT ON state- 
ment to determine the course of action to be fol- 
lowed for a particular selection. So you would 
enter a code number of 0, then set its string (or 
“description text’) to No. Next, you might enter a 
number i, and enter the text Yes, then possibly a 
number 2 and text "Don't Know’ if this is intended 
to make the program take a third course of ac- 
tion if neither Yes nor No is appropriate. Each op- 
tion can have its own selection letter although 
not all config programs allow this. Useful, but hard 
to master without practice. 

For byte, word, or long word values you have to 
enter a default value, the range of values (mini- 
mum and maximum) they can take, and the de- 
scription text for that option. 

Finally, the Select type offered by the QJump 
Config Block specification is not supported by 
Basconfig and cannot be used in this version at 
least since it can only be meaningfully used with 
Level 2 Config blocks. 

The basic extensions take the form 
C_typename(number). For example, to return the 
first config block string, you might use LET s$ = 
C_STRGS§(1), or to fetch the second byte value, 
you might use C_BYTE(2). The number refers to 
the number of that type of item, not the total 
item, e.g. if your config block has just one string, 
and one byte value, you would use C_STRG$(1) 
and C_BYTE(1) not C_STRG$(1) and C_BYTE(2). 
Please note that some versions of Basconfig re- 
quire you to set PROG_USE and DATA_USE 
commands to the name of the drive and directo- 
ry containing the program and its files, so that it 
can find its own files to create a config block. 
Some versions let you configure the program to 
tell it where to find these files. 

Some versions of Basconfig seem to have a 
small problem with string type items. Suppose 


we need to set up a string of 42 characters 
maximum to hold a filename. We set the default 
String to "FLP1_”, which of course is less than the 
maximum length. Later we reconfigure the config 
block and assign a longer string such as 
"WINI_DIRECTORYNAME_” and that causes the 
block to become corrupted for some reason. | 
don't know why this happens, but | do know how 
to avoid it - always create the config block with 
the longest possible string, in this example you 
could use 42 full stops, for example. It seems to 
work OK if strings become shorter, but not if they 
become longer than they were originally confi- 
gured, as though insufficient space is assigned 
during creation to hold the maximum length of 
the string unless that string Is as long as it Is al 
lowed to be. 

Verdict: Easy way to start writing config blocks 
for your programs, but only supports basic pro- 
grams, not assembler or C. Cannot alter config 
blocks it has created itself, Suffers slightly from 
being updated by several authors, so you are 
never really sure if you have the latest version. 


Q-Config 

| used version 1.21, by Rich Mellor It includes a 
copy of the original Basconfig, in an enhanced 
form with a few extra bug fixes and Special 
String Handling exclusive to this version of 
Bascontig. 

Q-Config is developed from and based upon 
Basconfig, but now with the addition of the Se- 
lect type, support for assembler output, support 
for level 2 config blocks and including the bug 
fixes included in the various earlier versions of 
Basconfig. 

When you start the program, it initially looks like 
Basconfig, but with a slightly smaller display than 
the version 113 of Basconfig | was using., and 
with the text ‘Configuration Extensions Level 2' 
across the top. 


Configuration Extensions 


@Liberated SuperBASIC programs, as well as rome you to 
Pcreate the source code required for an Assembly Progrom. 


Bug fix & LONG WORD handling by Norman Dunbar, Sth April 1994. 
Rdditionat Ba Fixes and Special String Handling by Rich Me{tor, 


4th March 
| Commercial i aralaos & Rich Mellor, 24th March 1998. 


Figure 3: Q-Config opening screen 


Even if you are familiar with the original Bas- 
config, it pays to read the new instructions, as 
Rich Mellor has greatly extended this program 
and expanded on the instructions. It uses the 
same extension names as the earlier version, but 
now includes a new function called C_SEL$ to 
return the values of Select type items. For level 2 
config blocks, it can handle both Registered and 
Unregistered names. Basically, what this means is 
that if the ID name is registered, it is guaranteed 
to be unique, so MenuConfig can store the pro- 
gram details in its menuconf_INF file. This allows 
MenuConfig to ‘learn’ the details from an older 
version of a program, then you upgrade to a new 
version and MenuConfig can use the information 
from the old version to apply to the upgraded 
program, so that you don't need to reconfigure 
the new version of a program from scratch - 
MenuConfig can “update” a program's config 
block if you like. 

To get a registered ID, you need to ask Jochen 
Merz or Wolfgang Lenerz (the SMSQ registrar) to 
issue you with a unique name which will not be 
allocated to anyone else's programs, e.g. | might 
get something like DEN’ or ‘DAV’. You can see 
examples of registered IDs on Wolfgang Lenerz's 
website at 
http://www.scp-paulet-lenerz.com/smsqe/Add1.htm! 

| couldn't apply to have DDE because it is already 
used for Data Design, but | could probably apply 
for other abbreviations of my name. Having 
unique registered ID names helps prevent any 
chance of confusion between program details 
stored in MenuConf_inf by MenuConfig programs 
when configuring programs. 

When you run this program, it asks first for the 
number of items you require in this config block, 
then prompts for level 1 or level 2 standards. 
Level 1 proceeds pretty much the same as earlier 
Basconfigs, except that you can choose bet- 
ween binary output (like the older Basconfigs, for 
use with basic programs) and assembler output 
(for programs written in assembly language). 
Level 2 will ask you for additional information 
such as whether the ID name you intend to use 
to identify the configuration block is a unique and 
registered name, or a simple unregistered ID. It 
will begin with an upper case letter and will be 3 
characters long if a registered name, or 2 charac- 
ters if unregistered. 

You are then asked to enter an item ID type for 
the item in the configuration block. Here, it starts 
to get a bit more complex! This can be a 
GLOBAL or UNIQUE type. Global Items allow you 
to set a default in one program and whenever 


you configure another program which contains 
that same Global Item, you can update the 
program so that it will adopt the same setting for 
that default as the other program. Wolfgang 
Lenerz’s web page currently lists 5 Global Item 
IDs: 


_COL Main Colourway : Byte : range ~1, 0 to 3. 

_Cos Sub-window colourway: Byte : range -1,0 
to 3 

_COB Button Colourway : Byte : range -1, 0 to 
3, 

_COE Explanation window Colourway : Byte : 
range -1, 0 to 3. 

_FFU Flash-frequency for update icon : Byte :f 0 


(steady) or ticks 


This behaves like a CODE item, and returns code 
values of 0-3 for the usual 4 colourways, and 
255 where the value -1 is inferred. 

A Unique item ID type is built up as the 3 charac- 
ter Program ID Name plus a number from 1 to 9, 
or letters if more than 9 items. So if I'd been 
given the unique ID DEN, my Unique config block 
items could be DEN1, DEN2, DEN3 and so on. 
From there on, it is pretty much like the original 
Basconfig, except for the Select data type, 
which can only really be used with Level 2 
MenuConfig. Select data type allows you to 
present the user with various options and the 
user can select one or more of these options to 
be effective. If you use level 1 Config program, 
only one of these options can be selected. You 
need to read the instructions carefully to correct- 
ly set up and use this data type and its associa- 
ted C_SEL$ extension. 

For assembler users, the instructions also show 
how to use the item pre-processing and post- 
processing routines, which was useful because | 
have never seen examples of how to use this 
facility, which is normally set to zero to indicate 
no routines are included. 

Verdict. A great update to Basconfig which 
retains the ease of use of the original Level 1 
Basconfig but now supports Level 2 as well, plus 
provides other features not in the original. Also 
cannot alter config blocks it has created itself 
thought about 


[Editor's note: We never 


“personal” IDs for personal usage. Mind you, 
the number of QLers should easily allow to fit 
into three-character-abbreviations. The registra- 
tion of IDs is done by Wolfgang Lenerz only 
(not Jochen Merz anymore), so if you would like 
to get “your” personal ID, please contact Wolf- 
gang - but maybe not all at once!] 


Quanta has not responded to QL Today's offer of 
2,000 words to present their case in QL Today 
So we have decided to help them out: 


"Members of Quanta will have noted a much 
improved print quality in the Quanta Magazine.” 
QL Today V10 I4 P6 


‘Quanta can proudly boast that it is the only QL 
publication that has survived as long as the QL, 
but for almost 10 years now it has been strug- 
gling, and has become a poor shadow of what 
it should be. In the last few months the Quanta 
committee have put a lot of effort into restoring 
its reliability and readability, and are having 
some measure of success. We at QL Today 
wish them well.” 

QL Today V10 I5 P3 


"Roger is a QL-er who lives in Spain and he is 
slowly modifying the Psion suite for use on high 
resolution GD2 colour screens. He sees this as 
being very much a Quanta project and his work 
iS a major acquisition for the Quanta library” 

QL Today Vi0 I5 P28 


"The last item of the Manchester weekend was 
the Quanta AGM. This has been a good year 
for Quanta and the chairman was able to make 
a positive report to members.” 

QL Today V10 I5 P29 


‘The committee have also been looking at 
shows and hope to stimulate interest in these 
by paying for bed and breakfast costs for 2 or 
3 lecturers and demonstrators.” 

QL Today V10 I5 P29 


"Roger Godley clearly sees his work as being a 
Quanta project, and thus (the programs) are 
unlikely to be available via the internet or other 
software libraries. This may disappoint some 
QL-ers who are not Quanta members, but then 
a year's subscription to Quanta would be a 
small price to pay for software improvements 
of this quality. 

QL Today Vi0 15 P44 


“Talks and demonstrations are back in fashion at 
(Quanta) shows and organisers are now expec- 
ted to beg, borrow or hire a computer projector’ 
QL Today V11 1 P17 


"Statistics may give a picture of an ailing organi- 
sation, but Quanta has made some progress in 
recent months. The Quanta Magazine has im- 
proved considerably; there has been a welcome 
improvement in publicising committee decisions; 
and a greater willingness to exploit some of its 
capital.” 

QL Today Vii 12 P53 


“Quanta has published the first electronic edition 
of the Quanta Magazine available to all mem- 
bers. It is a bumper 40 page issue weighing in 
at a slim 337Kb. 

"Hero of the piece is acting editor John Gilpin. 
He temporarily took over the editorship in 2005 
even though he had no previous experience of 
magazine publishing. John quickly learnt to 
master Page Plus and, during his tenure, the ma- 
gazine has vastly improved in both content and 
print quality. Praise also has to be given to 
Quanta chairman, John Mason, for the high prio- 
rity he has given to the magazine, which previ- 
ously had been neglected by successive com- 
mittees.” 

QL Today V11 14 P4 


"For years Quanta members have moaned 
about the poor quality of the magazine, but in 
the last 18 months John Gilpin and John Mason 
have achieved something quite remarkable. 
They have turned the Quanta Magazine back 
into a serious QL publication.’ 

QL Today V11 14 P62 


"This year | have said on many an occasion that 
real gains are being made in Quanta; that 
Quanta is lucky to have an efficient secretary; 
that through his hard work another committee 
member has made significant improvements to 
Quanta; that Quanta appears now more willing 
to exploit its capital than previously; and that 
Quanta has been unfairly maligned by many 
people over its supposed failure to fund Gold- 
fire’ 

QL Today Vii 14 P63 


“The Quanta Magazine has had a good 2006 
and can now claim to be a serious QL publi- 
cation once again. Other good Quanta news is 
a completely renewed website.’ 

QL Today V11 15 P3 


“Quanta has financed by means of a loan the 
manufacture of 200 new keyboard membranes’ 
QL Today Vi1 15 P5 


‘The greatest interest was in Dan Abbott's de- 
monstration of the new Quanta website. Dan 
has little experience of the QL community be- 
cause his interest in QL architecture comes via 
the OPD. He joined Quanta and accepted nomi- 
nation to the committee to become webmaster 
At the moment he is on a steep learning curve 
to familiarise himself with the people and tradi- 
tions of the QL community. 

"Dan impressed most present by his willingness 
to listen to members’ opinions and ideas. He 
clearly takes a flexible view of the website he is 
creating, and appears to be prepared to modify 
it in the light of experience and possible future 
developments.’ 

QL Today V11 15 P28 


"(Geoff Wicks) proposed a vote of thanks for 
the high quality of the minutes, but strangely no 
other person backed this up. Why do Quanta 
members find it so difficult to thank their com- 
mittee when they are doing something well?” 
QL Today V11 15 P29 


‘In your reporter's opinion this was probably 
one of the best Quanta AGM weekends for 
some time. Both Dan Abbott's website presen- 
tation and the AGM itself had a high level of 
member participation and this is something 
Quanta should encourage.’ 

QL Today Vi1 I5 P30 


‘Quanta now has an interesting committee. 
Although it is too small in numbers, it is filled 
with hard workers and probably for the first time 
in years has no dead wood’ 

QL Today V11 15 P30 


“Quanta’s committee are planning a party to 
celebrate the QL’s quarter centenary in 2009. It 
will be a good opportunity for the rest of us to 
show our appreciation of their work and 
achievements. What better way to do this than 
for others to take over and continue to build on 
their work with the same enthusiasm?” 

QL Today V12 Ii P3 


‘The easiest thing for the Quanta committee 
would have been to have scrapped the Mid- 
lands venue and move the show elsewhere, 
possibly Manchester However they did not 
choose the easy option as a matter of principle. 


Some years ago | had researched the demo- 
graphy of Quanta and had identified the Mid- 
lands as being a black spot where there was a 
concentration of members, but no workshops. 
The Quanta committee had decided to hold a 
show in this area as a matter of policy and they 
were not going to go back on this decision. 
They would find an alternative venue.’ 

QL Today V1i2 Ii P50 


"Dilwyn demonstrated the QL On A Stick to an 
interested audience at the Quanta Birmingham 
Workshop early in October Present at the de- 
monstration was Quanta chairman, John Mason, 
in case there was still a role for Quanta to play 
in the future development of the project’ 

QL Today V12 |2 P4 


"| also make an analysis of the Quanta Maga- 
zine each year and the differences between 
volume 23 and volume 24 are striking. The 
average size of the magazine has increased 
from 34 to 41 pages and editorial content from 
25 to 31.5 pages. The number of contributors 
has risen from 9 to 14 Well done Quanta com- 
mittee!” 

QL Today V12 14 P3 


"Rich's most successful lines are Spectrum and 
QL keyboard membranes, and the last batch of 
these was financed by a loan of £2,150 from 
Quanta." 

QL Today V12 14 P8 


"NEMQLUG, who run the show, have mastered 
the art of running near traderless shows and, to 
their credit, this year they achieved the best 
attendance at a Quanta AGM for some time.’ 
QL Today V12 14 P30 


‘The meeting can probably best be described 
as short and sweet. The chairman was able to 
give a positive report of 2007 with successful 
shows held in Hove and Solihull; standards 
being maintained in the magazine and electro- 
nic publication proving worthwhile; a renewed 
website; and new committee members. 

The treasurer was also able to give a positive 
report with the organisation breaking even.” 

QL Today V12 14 P33 


"At the Solihull show last year chairman, John 
Mason, told QL Today he could sense a 
renewed interest in Quanta and events since 
then confirm this.’ 

QL Today Vi2 14 P36 


"A member of the committee told QL Today the 
word ‘change’ was frequently used in their first 
meeting, which immediately followed the AGM. 
This indicates the committee are ready for the 
changes ahead, but will they get more active 
support from the members than they are pre- 
sently getting? UK QL-ers may be more depen- 
dent on the survival of Quanta than they 
realise.” 

QL Today V12 14 P36 


"Rich Mellor’'s most popular line is keyboard 
membranes, a good opportunity to remind 
everyone that these were financed by a loan 
from Quanta.” 

QL Today V13 It P55 


‘Logically as trading diminishes Quanta will 
become increasingly important for the survival 
of the UK scene.” 

QL Today V13 It P55 


In QL Today of sept-october 2003, on page 36, 


there is a short program for playing simple music 
on the QL. (The ‘Tempo’ procedure has been re- 
written for Bruno Coativy, to make it correspond 
exactly with actual tempo rates, as at the time | 
wrote the program | did not have exact data to 
do this). If anybody requires the latest QL_ Tunes 
program, then | will let them have it if they send 
me a floppy-disk, (without S.A if outside the 
Euro-zone), via the editor 

[Editor's note: | suggest we put it onto the QL 
Today website as soon as Steve lets us have it 
in the latest version, and we can send it out on 
floppy disk provided you send us 3 Internatio- 
nal Reply coupons to cover for the postage 
and the floppy disk ... no need to send empty 
disks around]. 


My first attempts at writing music were full of 
confusion, as | imagined that the QL BEEP 
parameters should correspond to some sort of 
scale, as in MIDI for example. | had bought books 
on computer music, and noticed that MIDI values 
corresponded to decimal-wave values. But 


DECIMAL?!? | had always believed that, (since 
Pythagoras), harmonics were combinations of 
WHOLE numbers! (1/2, 2/3, etc., Tierce, Quint 
seventh etc). Just take a look at the following 
MIDI note-values, taken at random: 


And finally: 


SHUM MISHTAKE SHURELY 
"Geoff Wicks, once more, somewhat mischie- 
vously seeks to diminish Quanta completely 
oblivious that in so doing he diminishes himself” 
Quanta chairman, Quanta Magazine V25 |2 P5 


"(Geoff Wicks added) that he had always felt 
that John (Mason) was an excellent chairman. 
Quanta secretary, Quanta Magazine V25 |2 P8 


Memo to Quanta: If two Quanta officers wish to 
mislead Quanta members about QL Today's 
editor they should first talk to one another to 
ensure they tell the same story. 


Octave —_ Value(Hz) 


No. Name 

24 ~~ doh 1 32.70 

38 ray 2 73.42 

52 mi 3 164.81 etc. 


This strange ‘decimal’-pitch situation has existed 
since musical instruments were first standardised, 
to allow them to accord harmoniously in 
orchestras, if with difficulty There is a simple 
method of constructing any gamut of musical 
notes, so | wrote a program where the QL would 
do the hard work, and then tried to adapt those 
scales to the QL. 

But to no avail, as the QL BEEP tones do not 
appear to correspond to any logical sequence. 
However, | did experiment quite a bit, and ended 
up by noticing an incredibly regular suite of 
whole-number notes. 

Briefly, lf you set middle ‘C’ (Doh) at 512Hz, and 
then calculate all the other notes from there, you 
end up with an almost complete range of notes 
covering the entire audible range, ( 20Hz - 
20,000Hz)}, and almost all of which are WHOLE 
numbers and EXACT harmonics from 1/3rd right 
down to 1/19th... 


So then | wanted to experiment the range with 
actual music, but current orchestral instruments 


are all based on MiDl-style ‘decimal’ notes start- 
ing from no. 64, ‘La’, octave 4, at 440Hz, (one of 
the few MIDI whole-numbers}. So all traditional 
instruments are made to correspond to decimal 
(approximate) tones, meaning they cannot play 
the new integer gamuts. 

Not to be discouraged, | went to visit the Senior 
Laboratory Technician at our local High School, 
and he set up their Sound Oscillator Equipment 
based on the new (Integer) scale, and exami- 
nation of their Oscilloscope output proved that 
playing fundamental notes also played all 
harmonics down to 1/19th simultaneously, 


So that was proof of the system. All that remains 
now is to accord an electronic keyboard with the 
new Integer Scale and play exactly harmonic 
music. Why a keyboard? Because otherwise you 
would have to make a whole new set of orches- 
tra instruments. After being used to ‘traditional’ 
harmonies, the new Integer ones sound too 
‘clean’ and ‘pure’ to be true, but as | cannot play 
keyboards, | will let others do the remaining work 
of playing the instruments and listening to the 
new integer music. 


One thing that strikes me is why this was 
apparently never done before? The calculations 
are perfectly accessible by hand, and reprodu- 
cing the new notes would not present any parti- 
cular difficulty for most instrument-makers. No 
doubt, somewhere in India there is at least one 
music Guru using this scheme, as they are not 
only very versatile musicians using gamuts 


100 :: 


virtually unknown to western music, but also ex- 
cellent mathematicians, and so they have been 
for countless generations. 


lf any readers try playing music on a 
so-redefined keyboard, | would be grateful if they 
would let the editor have their comments. 


nb: To keep the program simple, whilst it 
calculates the frequencies of notes, it does not 
place them in each octave in ascending order. To 
do so would greatly complicate the coding. But 
with the entire range on screen for each harmo- 
nic set, | will leave the ordering operations as an 
exercise for you. | would ask readers to bear in 
mind that such sorting depends on the way in 
which the human brain interprets pitch, which is 
not directly dependant on any obvious charac- 
teristic. 

As an example, the fifth octave frequencies are: 
doh-512, ray-576, me-648, fah-729, sol-768, 
lah-864, si-972. 

If you examine the first octave figures, you will 
see that to get the correct order you have to 
jump from column to column, listening to each 
generated pitch as you go, and deciding in which 
octave each note fits. If anyone knows a method 
of programming this | would be glad to hear of it. 
But strangely, in this age of all-automation, there 
are still some operations which can only be done 
by hand! If | knew the theory, | would also try 
tackling all other keys, including majors and 
minors etc. Any offers? 


110 REMark Binary_Gamuts_bas, by S.Poole. vtsept2006 
120 REMark Notes outside audible range are noted as '0' 
130 REMark Note how new decimal notes are rare: 


140 : 


150 OPEN#1,con_16: WINDOW 512,256,0,0: CLS: UNDER 0 


160 : 
170 FOR Harmonic=1 TO 19 STEP 2 


180 h_2=Harmonic/2: PRINT \ ' Harmonic: ';Harmonic 

190 : 

200 FOR hz=5 TO 13 

210 h=2“hz: UNDER 1: PRINT h,: UNDER 0 

220 : 

230 FOR n=1 TO 6: h=h*h_2: IF h<«20 OR ho 20000: h=0: END IF : PRINT;h, 
240 PRINT 


250 END FOR hz: i$=INKEY$(#1,1000) 


260 END FOR Harmonic: CLS: WINDOW 512,206,0,0: STOP 


270 :: 


| once wrote a calendar program for the QL. As | 
write this | can picture some of our more 
seasoned readers stifling a yawn and muttering 
"So what”. 

Calendar programs are old hat. They were one of 
the staples on which many of us cut our pro- 
gramming teeth. The first book on programming | 
bought had a calendar program that just fitted in 
to the 1K of a ZX81. 

some years ago David Denham wrote a series 
of articles on clocks and calendars for QL Today. 
If you are interested in looking them up you can 
find them in Vol. 6 issue 5 page 15; Vol. 6 issue 6 
page 48; Vol. 7 issue 1 page 45; and Vol. 8 issue 
4 page 16. 

Stephen Poole has also written a calendar 
program that appeared in Vol. 9 issue 2 page 48. 
This is the only program | have seen that allows 
you to work in either the Julian or the Gregorian 
calendar. 

| have seen many calendar programs but there is 
something missing in them all but my own. Let's 
look at a prac- 
tical example. 
Suppose it is 
your job to 
plan the date 
for the next 
Quanta AGM. 
This is a more 
difficult — task 
than you might 
think because 
the constitution 
says that mem- 
bers have until 
ist February to 
nominate candi- 
dates for office: 
that the mem- 
bers have to 
be given at 
least 28 days 
notice of the 
business of the 
meeting; and 
that the latest 
date for the 
meeting is 30th 
April. In theory 
this is a win- 


Tu We Th Fr 


23 4 
910 11 
16 17 18 
23 24 25 
34 31 


PAP R EES 


dow of about 9 weekends on which the AGM 
can be held. In practice it is only half that 
because the business of the meeting has first to 
be edited, printed and distributed. There is a 
further complication that the Easter weekend 
falls somewhere in that window. 

You can call up your QL calendar program to 
enable you to choose the best weekend, but you 
also have to hunt for your diary because your 
calendar program does not tell you the date of 
Easter 

Wouldn't it be nice if your calendar program also 
displayed public holidays? That is what my 
program does. If you want to look at it you can 
download it from the downloads page of my 
website: 
http://members.lycos.co.uk/geoffwicks/justwords.htm 
(Your system will have to be able to display GD2 
colours and have a resolution of at least 800 x 
600. This is the minimum resolution that can 
comfortably display a calendar for the whole 
year on a single screen) 


Tu We Th Fr Sa 
13 i415 


2@ 21 22 
27 28 29 


We Th Fr 


Why am |! the only person who has included pu- 
blic holidays in his calendar program? There is a 
Clue in the program description on the website. It 
only displays English public holidays. And when | 
say English | mean just that. The program does 
not correctly display Scottish or Northern Ireland 
public holidays. 

In other words it is easy to write a universal 
calendar program, but it is impossible to write a 
universal public holiday program. Each land has 
its own public holidays and even within a land 
there can be regional differences. 

In this situation QL-ers have an advantage over 
users of other computer systems. The ease of 
programming in SuperBasic means that it is pos- 
sible to write a tailor made calendar program. 
Even if you have no wish to write your own pro- 
gram, you could still amend someone else's to 
include your country's public holidays. Nor do you 
need to stick to public holidays. If you are Muslim, 
Jewish or other religion you may be able to pro- 
gram in your holy and feast days. If you wanted 
you could even tailor your program to show fa- 
mily birthdays and anniversaries. 

Public holidays come in three types. There are 
fixed days; occasionally variable days; and totally 
variable days. 


FIXED DAY PUBLIC HOLIDAYS are the easiest to 
program. We all know that Christmas Day is on 
25th December and News Years Day on Ist 
January, In your print routine you will have 
commands like PAPER 7: INK O. A simple line of 
basic reverses these: 

IF month = 12 AND day = 25 : PAPER O : INK 7 
(But do not forget to reset to PAPER 7 : INK 0) 


OCCASIONALLY VARIABLE PUBLIC HOLIDAYS 
can come in various sorts, some of which are 
easier to program than others. In the Netherlands 
the monarch’s birthday is an important public holi- 
day. If a monarch dies or abdicates you will have 
to reprogram your basic. (As it happens the pre- 
sent Queen's birthday is at the end of January. 
As this is not a suitable time for the street mar- 
kets and parties that are a feature of the day the 
celebration still takes place on her mother's birth- 
day) 

Many decades ago the UK elected a Labour 
government after many years of Conservative 
rule. They rewarded us by an extra public holiday 
and what better day than ist May - the day of the 
worker. 

This was simple to program: 

IF month = 5 AND day = 1 : PAPER O : INK 7 


However the Labour government was short-lived 
and when the Conservatives came back in po- 
wer the idea of a public holiday to celebrate the 
worker was abhorrent. But no politician would 
dare take a holiday away, and so they cunningly 
changed the holiday from ist May to the first 
Monday in May and in so doing gave everyone a 
long weekend. The programming now has be- 
come a little more difficult: 

IF (month = 5 AND day< 8) ANDcd/7=INT(cd/7) : 
PAPER 0 : INK 7 

(In my program cd/7 = INT(cd/7) identifies the day 
of the week as a Monday) 

Some years later the government replaced the 
totally variable Whitsun holiday by an occasional- 
ly variable one of the last Monday of May. Then 
the code becomes: 

IF (month = 5 and day> 24) and cd/7 = INT(cd/7) 
: PAPER 0 : INK 7 

The British have another unusual public holiday 
rule. If Christmas Day, Boxing Day (the day after 
Christmas) or New Years Day fall on either a 
Saturday or Sunday then an extra public holiday 
is awarded. Thus in 2010 Christmas Day is a 
Saturday and Boxing Day a Sunday, so 27th and 
28th December become public holidays. 


ist January 
2nd Apri t 

4th April 

Sth April 

3rd May 

Bist May 
34th August 
25th December 
26th December 
27th December 
28th December 


New Yeors Day: 
Good Friday: 
Easter Sundoys 
Easter Monday: 
Moy Dow Holiday: 


Spring Bonk Hol idey: 
Summer Bank Holidey: 
Christmas Denys 
Boxing Day: 

Bank Holiday: 

Bank Holiday: 


A programming rule to cover that possibility is 
quite complicated. 

As a final example of an occasionally variable 
public holiday | shall return to the Netherlands. 
There is a continual debate about whether Libe- 
ration Day on 5th May is or should be a public 
holiday. The official answer is that it is a public 
holiday once every five years. However many 
firms treat it as an unofficial public holiday each 
year It is not easy to decide whether or not to 
program Liberation Day as a holiday or not. 


TOTALLY VARIABLE PUBLIC HOLIDAYS are the 
biggest headache and they are very common in 


lands where the public holidays are still largely 
church based. The most obvious is Easter which 
occurs on a different day each year. 

The rule is in fact very simple. Easter Sunday is 
the first Sunday after the first full moon on or 
after the Spring Equinox. To simplify matters the 
church cheated by defining the Spring Equinox 
as 21st March although it is in practice variable. 
The big challenge is how to turn this into a 
computer program and, frankly, | suspect the only 
QL-er who would have had both the astronomical 
and programming skills to do this would be 
Freddy Vachha. If it is any comfort to our collec- 
tive bruised ego then the algorithm the church 
uses to calculate Easter is not strictly accurate 
and is only guaranteed to work from 1700 to 


Fortunately others have done the work for us. In 
the Quanta library there are two programs for 
calculating Easter They can be found in the 
folder "ONEFILEPROGS’ on disk UGO2. The first 
program Easter_bas is by Darren Jones and the 
second program Easter2_bas by John Tanner. 
Even if you are not interested in Easter programs, 
it is still instructive to look at these as John Tan- 
ner has reworked Darren Jones’ program to 
make the basic more compact. 

If you are not a member of Quanta then you will 
also find the Easter algorithm in David Denham's 
third article (Vol. 7 issue 1 page 45). Finally the 
website: 


George Gwilt writes: 

Letter Commenting on Norman Dunbar’s replies 
to my comments on part 21 

in Letter-Box of QL Today Volume 13 Issue 1 Nor- 
man Dunbar thinks that "the CLOSE% command 
can only close SuperBasic channels (or those 
contained within a compiled SuperBasic pro- 
gram)’. 

The syntax given in TK3 Is: 

CLOSE% channel close an internal channel 


The word ‘internal’ is used to distinguish this from 
a SuperBASIC channel. 

It is interesting to speculate how CLOSE% might 
be programmed to do this. 

The number of an internal channel is its position 
in the system channel table (0, 1 2 etc). The ad- 
dress of the base of the system channel table is 
$78 bytes from the start of the system variables. 
We can thus find the entry for the channel to be 


www.bbc.co.uk/dna/h2g2/A653267 

gives the algorithm in a suitable form for use in a 
basic program. 

Once you have worked out a date for Easter the 
other holy days are easy to calculate. Ascension 
day is the Thursday after the 5th Sunday (ie. 39 
days) after Easter and Whit Sunday is 7 weeks or 
49 days after Easter. 

lf you want to explore the possibilities of QL ca- 
lendar programs | have a final word of warning. 
Many of the published programs stem from the 
early years of home computing and are not writ- 
ten to the standards of the present day. In the 
early years memory was small and a good 
program was one in which the code was as 
compact as possible. Thus in John Tanner's 
Easter program you will find a line: 
a=jMOD19:b=jMOD4:c=jMOD7: t=19*a+24 
Nowhere are you told what a,b,c and t are. To- 
day with our abundance of memory we would 
use year’ as the variable instead of "}’ and be 
told in a REM statement that b = | MOD 4 isa 
leap year calculation. 

The best place to begin is David Denham's 
articles. They were written about 6 years ago 
and are much easier to follow. 

Adding public holidays to a calendar program can 
be an interesting challenge, but one in which you 
could well be on your own. If you are successful 
then do not be selfish. Share your program with 
your fellow countrymen. 


closed. This is a long word pointing to the chan- 
nel block for that channel if the channel is open. If 
the channel is closed the long word pointer is ne- 
gative. Simply to close that channel, if it is open, 
is quite easy, Just use IOLCLOSE with the ID of 
the channel in AO and it's done. The ID of the 
channel is a long word with the channel number 
in the bottom word and the tag, which is in the 
word $10 from the start of the channel block, in 
the top word. 

However, to implement Norman's suggestion we 
must test whether the channel belongs to an 
S*BASIC job, which means either the master 
BASIC or a daughter BASIC. This can be done, in 
SMSQE, since all S*BASIC jobs have "SBAS’ in 
the long word just before A6. We thus have to 
test this for a target channel. The ID of the job 
owning the channel is in the long word $08 from 
the start of the channel block. We can use this to 
find the address of the job control block of the 


Feeling out on a Limb? We can accept payment by 


Reach out for QBranch Visa, Mastercard, Maestro and 
Suppliers of Quality QDOS/SMSQ products Switch. We also accept sterling 
Hardware and Software cheques drawn on a UK bank. 


r payment direct to our bank: 


Natwest 
20 Locks Hill Sort code 60-17-01 
Portslade Acc. 84534826 
Sussex BIC : NWBKGB 2L 
BN41 2LB IBAN : 
UK GB34 NWBK 6017 0184 5348 


Mobile: +44(0)7836 745501 
email : sales@qbranch.demon.co.uk 
www.qbranch.demon.co.uk 


QBranch is closing down! 


After 12 Years selling QL Software and hardwWare we have finally come to 
the end of the road. We would like to extend a big thank you to all the 
customers Who have supported us over the Years and We hope that you 
will all continue to use the QL and its emulations. 

We don’t hold much stock any move but see below for closing down sale 
items, 


Text87 plus 4 £25.00 


Fountext94 £ 5.00 
Qliberator £15.00 
Basic Linker £ 5.00 
WinEd £ 5.00 
QBasic £ 5.00 
HyperHelp for Basic £ 5.00 


Super Games Pack £ 
Avcanoid E£ 2.00 
Mine Field £ 3.00 
Pipes £ 3.00 
FiveBivds £ 2.00 
QShang £ 2.00 
Black Knight 


For most of the items above I have only one or te copies. I also have 
most back issues of QL Today @ £1.00 each. Prices do not include Post 
and Packing. 

Any items left after Jan 3 1st will be disposed of. 


job owning the channel. Then we find the value 
of A6 from the long word $58 bytes from the 
start of the job control block. So we could, with a 
bit of programming, avoid closing channels which 
are not S*BASIC. 

What of compiled tasks? | can only speak for 
those compiled by Turbo. | have a program 
ADJ_DS which will report, and allow alteration of 
the dataspace of all jobs and the stack space of 
Turbo compiled jobs. Thus | must be able to pick 
out these Turbo compiled jobs. The code | have 
used could, obviously, be used to allow the 
closing of channels owned by such jobs. In fact | 
find these jobs by checking that the first few 
bytes of the program contain a Turbo version 
number. 

Well, it is theoretically possible that CLOSE% 
could do something like that. In fact it does not. It 
does just close the channel with system number 
‘channel’. What is slightly amusing is that, while 
most accesses to channels require the whole ID, 
CLOSE% just asks for the channel number 
without the tag. This means that you could 
sometimes close the wrong channel. How? 
Suppose you establish which channel number 
you want to close. This takes some time. Even 
using CHANNELS from TK3, which quickly prints 
all system channels, takes a few seconds while 
you tap away at the keys. By the time you get 
round to typing CLOSE% 126 (or whatever), that 
channel may have been closed and another one 
opened at the same position in the channel table 
but with a different tag. After all the QL is a 
nicely multi-tasking computer. 

Finally | should report that recently, while trying to 
find the error in a colleague's assembler pro- 
gram, | noticed that | could not use the floppy 
drive. All access was denied. | looked at the 
channels opened for that job and found one 
open to a file on a floppy disk. Since we had re- 
loaded the drive with a second disk the SMSQE 


software refused to deal with it. | solved the 
problem by using CLOSE% to close that channel. 
After that the floppy disk drive was operational. 


George Gwilt also writes: 
Letter Commenting on a “quick reply from 
Jochen" 
At the end of my article about resizing windows 
in QL Today Volume 13 issue 1, Jochen gave an 
explanation of why QD moved horizontally on a 
resize. In fact this caused me to examine resizing 
even more closely. | found that in some cases 
windows which | thought would have a stable 
bottom right corner in fact moved slightly, always 
to the left by a couple of pixels or so. 
| discovered that, to maintain a rock steady bot- 
tom right, you have to do three things. 
1. Find the new position for WMPRPOS as 
explained in my article. 
2. Make sure that the number of pixels 
change horizontally is divisible by four. 
3. Make sure that the minimum x-size for the 
window is divisible by four. 
| have experimented with my windows con- 
straining the amount of horizontal change to 
multiples of some chosen number and found that, 
if the three rules above are obeyed there is no 
movement of the window on resizing. 
So | still don't understand the quirky QD move- 
ment! 


[Jochen replies: Thanks, George .. after all 
these years, | am not sure that the resize 
routine checks your points 2 and 3. They 
should, because you are right - it could lead to 
small moves by a couple of pixels to ensure the 
window/colours matches stipple positions, | 
think. | will look into QD to see if that's the case 
after the magazine has been finished and done, 
and after | finish a few small changes on 
QMENUI. 


The QL character set is made up of a collection 
of character definitions gathered together in a 
piece of data called a Font. In Sinclair QL 
terminology, it should more correctly be called a 
Fount, but since everyone seems to use the 
word Font, so shall we. 

Each character is defined on a 5x9 grid of dots, 
called pixels (which in turn stands for Picture 
Elements). When a character is to be drawn on 


the screen, it is done so using this 5x9 grid of 
pixels, and spaced by one pixel between 
adjacent characters both across and down, in 
effect a 6x10 pixel grid per character, but only 
5x9 of these pixels can be defined for each 
character in the font. This 5x9 grid forms a 
pattern which tells the computer how to draw 
each character on the screen. 


Please see figure 1 for a diagram showing how 
this works in practice. This shows how an upper 
case letter A is defined. 


Figure 1 - Character definition 5x9 grid 


In this diagram, each black square represents a 
pixel which is set in INK colour on the screen for 
this character and each blank (or white) square 
represents an unset pixel on the screen which is 
normally printed in paper colour (assuming OVER 
0 Is set). 
This grid in effect represents a binary version of 
the character Each line across is encoded into a 
byte value, using bits 6 to 2 inclusive, which 
leaves one blank bit to the left and two to the 
right. Since each character has 9 lines of pixels 
across, 9 bytes are needed to store up the dot 
pattern for each character The top row of a 
character on the screen is stored in the first byte, 
and so on, down to the bottom row. 
Here's a sample of what a solid character (all dots 
set) might look like in binary: 

01111100 

01111100 

01111100 

01111100 

01111100 

01111100 

01111100 

01111100 

01111100 


Built-In Fonts 

The QL has a default character set built into the 
ROM. This covers all of the characters which the 
QL can print, but split into two fonts. The first co- 
vers all characters with codes up to and including 
127. The second font covers all of the characters 
which are referred to as "the extended character 
set’ or those characters such as accented let- 
ters. What happens is that if you ask to print a 
certain character code, the QL looks to see if it is 
a character definition stored in the first font. If not, 


it then tries to see if it is a character stored in the 
second font. If not found in either a stored default 
character is printed instead. On a standard Sin- 
clair QL, this would be a *chequerboard” charac- 
ter - to see it try PRINT CHR$(31). 


New Fonts 

It is possible to provide the QL with a new font if 
you so wish. In fact, any channel of any program 
can in theory at least have its own character set. 
Over the years, many people have designed 
their own character set and many are available 
free from PD libraries and QL-related websites. 
There is a page on my website devoted to QL 
fonts - point your browser at 
http://www.dilwyn.uk6.net/fonts/index.html 

and look for the general QL system fonts you 
can download. 


Font files usually have the following file exten- 
sions: 


_fnt or 

_font A standard QL font 

_fat A ‘fat’ font (8 pixels wide - see below) 
_chs Also a standard font, chs stands for 


CHaracter Set 


To load and use these new fonts, you have to 
load them into memory and use a Toolkit 2 ex- 
tension called CHAR_USE to tell the system to 
use that font for the channels you indicate in the 
command. 

The first thing we need to do is to find the length 
of the font. Let us assume it is called sample_tnt: 
100 filename$='flpi_sample_fnt' 

110 LET font_size = FLEN(\filename$) 

120 base = ALCHP(font_size) 

130 LBYTES filename$, base 

140 CHAR_USE #1,base,0 

150 FOR a = 32 TO 191 : PRINT #1,CHR$(a); 


Line 110 checks the font size. Line 120 allocates 
enough space in the common heap for the font 
file. Line 130 loads the font into memory. Line 140 
specifies that the font applies to screen channel 
#1, and the first font is the one replaced, while 
the second one remains as the font built into the 
QL ROM. Finally, line 150 prints all of the charac- 
ters so that you can see what they look like and 
which have changed. 


The CHAR_USE command takes the following 

form. 

CHAR_USE [#channel,] fonti_address, 
font2_address 


If you omit the channel number, it will default to 
channel #1. If either fonti_address or 
font2_.address is given as a value of zero, that 
means "use the font in the ROM’. So, to reset to 
the font in the ROM, you could use 

CHAR_USE #1,0,0 

which resets both fonts. You would also need to 
release any common heap space you have used 
with an RECHP command. 

SMSQ/E (SBASIC) users have an extra option in 
the CHAR_USE command. If a value of -1 is given 
in place of 0, it means leave this font unchanged 
(use the existing definition). Therefore, 

CHAR_USE #1, font_address,-1 

means use the font definition at "font_address’ 
for the first font, but don’t change the second 
font. 


Changing Default Fonts 

You may have noticed that the CHAR_USE com- 
mand only lets you change the fonts for a single 
channel of a single program. On traditional Sin- 
Clair QLs there is no easy way to change the de- 
fault system font as it is built into the ROM, fixed 
and unalterable. But, on SMSQ/E systems, 
SBASIC has a command called CHAR_DEF 
which can change either or both of the system 
fonts if you wish: 

CHAR_DEF fonti_address, font2_address 


As with CHAR_USE, we can supply the address 
of a suitable font, or we can use a value of 0 to 
reset to SMSQ/E’s built in system font, or use a 
value of -1 to stick to the existing definition, 
unchanged. 

CHAR_DEF changes the fonts used by any 
newly loaded programs. But programs which are 
already in memory may continue to use the 
same font as before. It also has no effect on pro- 
grams which use their own fonts, such as gra- 
phics programs. 


Font Definition 

The first two bytes in a font file are special, as 
they contain the code of the lowest valid charac- 
ter in that font, and the number of valid charac- 
ters less one. This information tells us which 
character codes are defined in that particular 
font. For standard Sinclair QL fonts, the first 2 
bytes of both fonts are as follows: 

Font 1: 31 96 

Font 2: 127 64 


What this means is that for the first font (which 
usually covers the character set up to the copy- 


right symbol of CHR$(127) this font starts with 
CHR§(31) and there are 96+1 characters (97) in 
the font. This means that the code of the last 
character is 31+96, which is 127. So the first font 
has definitions for characters with codes from 31 
to 127. 

The second font consists of characters with 
codes starting at 127 and containing 64+1 (65) 
characters, which means it covers characters 
with codes from 127 to 127+64, which is 191. 
Fonts of this type are generally of the following 
file lengths: Font 1 is 875 bytes long. Font 2 is 587 
bytes long. 

After the first 2 bytes in each font file, each cha- 
racter is defined in a series of 9 bytes as defined 
above. So for the default font in the ROM, 
CHR§$(31) is defined in the 9 bytes after those 
first 2 bytes and so on. 

You may have noticed that both fonts define 
CHR$(127). There is a very good reason for this. 
The mechanism by which fonts are printed is as 
follows: 

The system looks up the character code in the 
first font. If it is found within the first font, it is 
printed using that definition. If it is not found in the 
first font, the system looks in the second font to 
see if it exists within that. If it does, it is printed 
using that definition. If it doesn't exist in the se- 
cond font either the character is printed as the 
first valid character in the second font. To see 
how this works, consider the example of 

PRINT CHR$(127) and 

PRINT CHR$(255) 

The system decides that CHR$(127) exists in font 
1, so it prints that to the screen. This is the copy- 
right symbol. 

CHR$(255) does not exist in font 1, so the system 
looks in font 2. It doesn't exist in that either so 
the system decides it has to use the lowest valid 
character in the second font, which is CHR$(127), 
but this is not the copyright symbol. CHR$(127) in 
the second font is a chequerboard symbol, and 
that is what is printed as the default character. 


Locating the Font in Memory 
Although it is quite easy to install new fonts as 
described above, there are times when you may 
wish to find the location of a font in memory, e.g. 
when you wish to study the dot patterns for a 
given character Unfortunately, neither Super- 
Basic, SBASIC, nor Toolkit 2 have functions which 
will tell us where the font is located in memory, so 
we have to resort to some other toolkits or 
extensions. 


The address of a font used by a given channel is 
stored in the channel definition block, at an offset 
42 bytes into the block (for font 1) or 46 bytes in 
(for font 2). What we need is an extension to 
return this information. 

The easiest way is to raid Simon Goodwin's DIY 
Toolkit, and use the CHAN_L function in Volume 
C. DIY Toolkit is available from my website's 
Tookits page at 

www.dilwyn.uk6.net/tk/index.html 


Once we have this extension resident, we can 
PRINT CHAN_L(#0,42) and 

PRINT CHAN_L(#0, 46) 

to see where the two fonts occur in memory. 


The CHAN_L function returns a long word from 
the channel definition block from a given offset 
within the block. The corresponding extensions 
for returning word and byte values are 
CHAN_W% and CHAN_B% respectively. These 
channel functions take care of working out 
where to look for the information, since the 
channel definition block may not stay at a given 
fixed address at any given time, so the address 
to look at is not too straightforward to calculate. 
lf you have Norman Dunbar's DJToolkit, there is a 
function called WHERE_FONTS to locate the fonts: 
WHERE_FONTS(#channel, 1_or_2) 

which returns the address of the font used for a 
given channel. 1_or_2 should be replaced with 
the number 1 or 2 depending on which of the 
two fonts you wish to locate. DJToolkit is avai- 
lable from the same website. 


How NOT to locate Fonts! 

A common problem with older QL programs is 
code which locates fonts incorrectly. Very old 
programs used a couple of PEEK_L commands, 
like this: 

LET font_addr = PEEK_L(167722) 


This is doomed to failure on modern systems as 
it peeks directly into the address where a chan- 
nel definition block might occur on an original, 
unexpanded QL, and makes no allowance for the 
slightly different channel definition block in mo- 
dern systems with pointer environment, for exam- 
ple. 

Another method seeks to work around this to 
some extent, but is also doomed to failure on 
many systems: 

LET font_addr = PEEK_L(42+ (PEEK_L (PEEK_L 
(163960)+4))) 


oa] ie 
aren 


You may find this second method works on 
some systems, as the PEEK_L(163960) looks for 
the address of the base of the channel table, but 
it could not hope to work on systems where the 
system variables have moved, for example. Such 
systems might include a Minerva system using 
the second screen, or an SMSQ/E system. So it 
is best to use CHAN_L or an equivalent function 
which enables us to locate the information 
‘legally’. 


Assembler 

For those who write in assembler, fonts are han- 
dled using the sdfount trap, which is trap #3 with 
d0=$25 or decimal 37. This is called with the fol 
lowing register parameters to set or reset the font: 


d3.w = timeout 
ad = channel ID 
al = base address of first fount (or 


zero to reset) 

base address of second fount (or 
zero to reset) 

dO can return -1 for ‘not complete’ (e.g. timed out) 
or -6 for ‘channel not open’. The following regis- 
ters are preserved: d2.L, d3.L, a0 and a2. 


a2 


Fat Fonts 

| stated above that QL fonts are based on a 5x9 
pixel grid. There is one largely undocumented 
special case which is an exception to this rule. If 
you use CSIZE 1,0 this allows fonts designed on 
an 8x9 grid to be used. For each of the 9 bytes 
used to define such a character, all 8 bits can be 
defined and some font editors allow you to do 
this. Such fonts can only be used in character 
width 1 (which is normally the same as character 
width 0 but with extra pixel spacing). Such fonts 
are uSually referred to as ‘fat’ fonts, or 8 pixel 
wide fonts, because they are 2 or 3 pixels wider 
than the standard characters. Sadly, these fonts 
cannot be used in any of the three other 
character widths. But although this is a largely 
undocumented feature, this does work across all 
QDOS and SMSQ/E systems | know of as it has 
been recognised and reproduced in all versions 
of the operating system to date. 

In practice, if you use character width 0, 6 of the 
8 pixels are displayed. This is because although 
the characters are normally defined using bits 6 
to 2 across each byte of a definition, the first 
(usually blank) pixel is used for the spacing and 
some versions of the operating system will faith- 
fully draw bits 7 through to 2. One example of 
use of such a font could be for continuously 
joined up handwriting fonts, for example. 


Character Spacing 

When we print characters on the screen, each 
character is usually spaced by at least one pixel 
(more than that in character width 1 and 3). Q(DOS 
and SMSQ/E do, however, support different cha- 
racter spacings by allowing us to specify diffe- 
rent pixel increments for each character. So, while 
CSIZE 0,0 characters are spaced 6 pixels apart, 
CSIZE 1,0 characters are spaced 8 pixels apart. 
CSIZE 2,0 and 3,0 are obviously spaced twice as 
far apart. 

Toolkit 2 uses the CHAR_INC command to set 
different spacings for text characters. Each 
channel can have its own spacing: 

CHAR_INC #channel,x_increment, y_increment 


lf you do not specify a channel number, it as- 
sumes channel #1. The x_increment is the num- 
ber of pixels from the start of one character 
across to the start of the next character and 
y_increment is the number of pixels from the top 
of one character to the start of the next 


The Toolkit 2 manual cites the following example: 


character down. Normally, there would be no real 
use for this command apart from creating un- 
sightly overlapping text. Try 

CHAR_INC #2,5,10 

to see what happens when editing a Super- 
BASIC program, for example. Note that the re- 
duction from 6 to 5 pixels across causes the 
rightmost pixel to be lost, since printing normally 
begins at bit 7 of a character definition, so you 
get the single pixel spacing, and then the first 4 
pixels of the character After trying the messy 
editing, now enter 

OVER #2,1 

to prevent the spacing pixel overwriting the 
rightmost part of the previous character and see 
that although hardly pretty, editing is now much 
easier! 

Note that if you change CSIZE, the increments 
are cancelled and reset to normal spacing for the 
selected character size. 

Where CHAR_INC can come in very useful is for 
when you define smaller characters than usual. 


“df there is a 3x6 character fount in a file called 'f3x6' (length 875 bytes), then a 127 column by 36 


row screen can be set up: 


MODE 4 

WINDOW 512-2,256-3,0,0 : REMark clear of edges of screen 
CSIZE 0,0 : REMark spacing of 6x10 

CHAR_INC 4,7 : REMark spacing 4x7 


fount = ALCHP(8'75) 
LBYTES £3x6, fount 


Using non-standard spacings like this also carries 
a warning in the Toolkit 2 manual: 

If the increment is set to less than the current 
character size (set by CSIZE) then extreme 
caution is required as it will be possible for the 
display driver to write characters (at the right 
hand side or bottom of the window) partly 
outside the window. The windows should not 
come closer to the bottom or right and edges 
of the screen than the amount by which the 
increment specified is smaller than the charac- 
ter spacing set by CSIZE.’ 

That was the reason for the "512-2" and "256-3" 
in the example above. 


For the technically minded, the character incre- 
ments are stored as 16-bit values in the screen 
driver data block definition at offsets $26 (deci- 
mal 38) for the x increment, and $28 (decimal 40) 
for the y increment. If you are using Simon 
Goodwin's chans_code extension from his DIY 


: REMark reserve space for fount 
: REMark load fount CHAR_USE fount, 0: REMark single fount only 


Toolkit, you can use the CHAN.W% function to 

read the existing spacing settings for any chan- 

nel: 

PRINT CHAN_W%(#0,38) : REMark print 
horizontal (x) increment for #0 

PRINT CHAN_W%(#2,40) : REMark print 
vertical (y) increment for #2 


lf you decide to create such small fonts to use 
with CHAR_INC, experiment a little to see how 
best to define each character. It would normally 
be best to design characters into the top left 
corner of a character definition, but allowing for 
one pixel spacing at the left unless you 
specifically want the characters to join up (eg. 
handwriting, or continuous box characters like an 
IBM character set on some printers). 


In the next part, | will show you how to edit fonts, 
how to print with shadows, how to outline text 
and other things. 


Introduction 

Did anyone notice | wasn't ‘here’ last time? Didn't 
think so! | was in Castelmola, Sicily again for two 
weeks enjoying the shade while my wife enjoyed 
the 40 degree heat and almost continual sun- 
shine. Mount Etna was in good flow and we had 
spectacular views of the mountain during the day 
and the red hot lava flows at night. The food was 
splendid - as Italian food is - and we had a great 
time. 

At the end of the last article in this series, | 
mentioned that we would be delving into the 
WMAN system next. Well, here we are. However, 
before we get down and dirty in the code, | need 
to make sure you all know what I'm talking about, 
SO let's start with a brief introduction/reminder to 
WMAN and all it's constituent parts. 


WMAN 


Until now, we have been playing with the PE or 
Pointer Environment routines. These allow for a 
window to be outlined, the pointer to be drawn 
and read and so on. However, to use these few 
routines to write applications with multiple win- 
dows and so on, loose items, menus whatever, 
would be quite difficult. This isn't to say that it 
cannot be done, it’s just difficult. 

What we really need is a utility to allow us the 
ability to define our window structure, the loose 
items and so on contained within it and convert 
that into what QDOSMSQ really needs to have to 
be able to give us all the goodies we get from 
the PE, well, WMAN is just that. 

Using WMAN we can define a window and all its 
contents, then use the vectors from WMAN to 
set up, display, remove and interact with our 
application without having to write code to 
handle everything ourselves. 

George Gwilt mentioned in a comment about part 
20 of this series that | treated the call to 
IOP_PINF as a method of finding out whether or 
not the Pointer Environment had been loaded. 
While it does indeed do this, it also returns a 
vector to the current location of the WMAN 
utilities in memory in ALL - and it is these vectors 
we will be exploring in the coming articles. 


A Very Brief Overview Of WMAN 
Before we go on, we need to know what all the 
bits of the PE actually are, so there now follows a 
small briefing on that very subject. | won't be 
spending a lot of time in the discussions so if 
you need further information there is a very 
good ‘Idiot's Guide To The PE” available on 
Dilwyn’'s web site at 
http://www.dilwyn.uk6.net/pe/peig/pe.html 

if you want to read it online or 
http://www.dilwyn.uk6.net/pe/peig.zip 

if you want to download it to read at your leisure. 


Selection Keys 

A selection key is simply the key that you press - 
when the pointer is over the appropriate primary 
window (see below) - to activate some function 
or feature of the program in question. It may 
Cause an action to be carried out or simply high- 
light an option is a menu. Normally, the selection 
key is shown underlined, but this is not necessa- 
ry, although it is more helpful to the user of the 
program if it is. 


Hit and Do 

When the mouse buttons are in use then a HIT is 
what happens when you click with the left 
mouse button and a DO is when you click with 
the right one. On the keyboard, a HIT is when 
you tap the spacebar and a DO is when you tap 
ENTER. The actions carried out when you HIT or 
DO may be the same or may be different - it's all 
down to how the programmers wrote the code. 


Outline or Primary Window 

| have mentioned outlines before, however, for 
the sake of completeness, I'm reiterating here. 
The outline (or primary window) is the rectangle 
of your screen that the program will perform all 
its workings within. Any secondary windows 
(see below) opened by the program must be fully 
contained within the area bounded by the outline. 
Of course, some programs allow you to move 
their windows around the screen. This also 
moves the outline around and wherever the 


window ends up when the user has moved it, 
becomes the new outlined area and all seconda- 
ry windows will now appear within the new loca- 
tion. 

The biggest size that an outline can be is the 
maximum width and height of the screen minus 
the shadow width and depth. 


Secondary Windows 

Secondary Windows are things like QMENU's ‘file 
open’ utilities and so on, pop-up messages 
giving you error messages and anything else 
that takes place within the outline or primary 
window. 


Information Sub Windows 

These are small areas of the primary or secon- 
dary windows that show static text or little ima- 
ges or whatever The most commonly seen and 
recognisable ones are those green and white 
stippled ‘caption bars’ that most PE programs 
have at the top of every window. 

Indeed, the caption bar for most PE programs 
that | know of is set up with a green and white 
stippled information window all the way across 
the top of the window, then on top of that there 
is another plain white information window nicely 
centralised horizontally on top of the first one. 
The program name or caption is then inserted as 
an Information Object (see below) into this 
second information window. 


Information Objects 

Once an information sub window has been crea- 
ted you need something to put in it - for informa- 
tion purposes. To this end you need to create 
information objects. These can be text or blobs, 
sprites or patterns (see below). The most notice- 
able ones are the program name shown in the 
‘caption bar’ of most PE programs. 


Loose Items 

Loose items are small ‘buttons’ with text or gra- 
phics on them. They usually have a border that 
magically appears when the pointer is within the 
bounds of the loose item in question. A hit or do 
on a loose item will cause some action to be 
carried out. 

The popular loose items known to most users 
would probably be the ZZz, ESC, resize and 
move ones that appear in the caption bar's of 
may PE programs. 


Application Sub Windows 
There's not much to say about the application 


sub windows really. They are what's left of the 
primary or secondary window after borders, 
information sub windows and loose items etc 
have been removed. They are the areas of the 
screen that the program prints its output or 
allows input from the user and so on. 

A graphics drawing program, for example, would 
use the application sub window to allow the user 
to draw whatever it is that they are drawing. 


Pan and Scroll Bars 

These are displayed if the data in an application 
sub window is too wide (pan) or too tall (scroll) to 
be displayed completely within the area of the 
screen set aside for the application sub window. 
GUI users on other system (Linux or Windows) 
will be familiar with the concept. 

At first, these can be a nightmare as a ‘DO’ within 
the scroll bar (or pan bar) will split it and you then 
end up with two separately scrollable {and/or 
pannable) windows within the application window. 
Could be useful at times | suppose! 


Sprites, Blobs and Patterns 

A SPRITE is a picture that appears on the display 
somewhere. A pointer is just a sprite that is 
moved around the screen. Sprites may be drawn 
to look like text, for example, in logos and 
programmer's names etc, or they may be small 
pictures to represent some function of the 
program. 

A BLOB is part of a sprite and holds only data 
that defines the shape It has no colour 
information at all. The PATTERN is the part of the 
sprite that holds the colour data. Why separate 
them like this? | suspect it was to save memory - 
why bother having sprites defined with the same 
shape, just different colours - by defining the 
BLOB once and the PATTERNS for the colours, 
you save repeating the blob data - perhaps? 
Blobs and patterns can be used independently of 
sprites though. 


Border 

The border around the primary and secondary 
windows, and indeed any other object, is optional 
and up to the programmer However, most pro- 
grams use borders. 

When you move the pointer over a loose item, a 
border may appear around it to indicate that you 
can carry out some form of action if you were to 
hit or do the loose item in question. Once the 
pointer is outside the loose item boundary, the 
border may vanish. 


Shadow 

The shadow for a window is drawn down the 
right side and along the bottom. It is optional and 
entirely at the discretion of the developer When 
in use, a shadow gives the impression that the 
window is hovering above the desktop. The 
shadow is outside the outline and does not 
register hit or do actions. It is purely decorative. 


More Useful Utilities From 


George 

The GWASL assembler that George Gwilt wrote 
has been used as the assembler of choice 
throughout this long running series. George has 
come up trumps again with another utility 
that allows the easy generation of assembler 
code that defines a WMAN windows definition 
(more on this later) and I've been testing it out. 
Unfortunately, my holiday got in the way and | 
have a new version of the utility and GWASL to 
test out at the moment. 

'm sure that these programs will soon be 
available from George's usual repository of fine 
code. In addition, | shall be trying these utilities 
out myself and reporting back. 


Standard Windows Definition 


WMAN Windows Definition 

As mentioned above, WMAN is slightly more 
involved than the bare bones PE in as much as it 
carries out a huge amount of work on your 
behalf. This is all work that you would have to 
write into each and every program you write 
using the PE/WMAN system (hereafter known 
collectively as the PE or the Pointer Environment) 
but in order to take advantage of all this hard 
work, you have to set things up in a standard 
manner. 

If you look back an issue or So, you will notice 
that up until now, all my PE test programs simply 
opened a console and set an outline before 
entering the main loop to read the pointer act 
upon it, repeat as necessary. Obviously, my test 
programs were small and insignificant - but even 
though, they could benefit from a bit more added 
‘sparkle’. The WMAN routines make this possible. 
The first thing we have to do is create a 
definition of our window in memory. This will be in 
a standard format and when done, we call a 
WMAN routine (WM_SETUP) to initialise the vari- 
ous internals required to make our window work 
under WMAN. Let's now take a look at the 
standard definition as required by WMAN. 


So, now you know what all the bits in a window are, we can get right in and start discussing the 
standard way we have to define a windows and all its decorations. Let's take a look at one that 
someone else prepared earlier. 

The following is extracted from a small utility written by Oliver Fink many years ago. The utility shows 
various bits of information about the running QDOSMSQ system. | have modified the original in a few 
places but the full credit must remain with Oliver The code is in the public domain. 

The start of the definition is the main window itself: 

3Main window definition : 


de.w 160 3 default window width 
de.w 84 3 height 
de.w 146 ; initial pointer x position 


de.w 8 3 y position 
So far so simple, nothing much here that we haven't met already. All we are doing here is telling 
WMAN how big our window is to be and where within the window the pointer is to be positioned 
when the window is first drawn. 
The above positioning of the pointer is relative to the window outline. So in our window which is 160 
pixels wide, the pointer is located 146 pixels along - nearly at the far right end. It is located 8 pixels 
down from the top. When drawn on screen, this places the pointer directly over the ESC loose item. 
When the program is first executed, the PE attempts to position the main window on the screen so 
that the requested position of the pointer is superimposed on the current pointer position on screen. 
This prevents disconcerting jumps of the pointer every time you start up a new program. 
You can see this in action if you move the mouse around on screen, note where it ends up, then EX a 
new program that uses the PE. You will see that the main window appears wrapped around where you 
last saw the pointer. 
Next we define the attributes for our window. 

de.b $00 3 MSbit clear to call CLS 

de.b 2 3 shadow depth 


de.w 1 ; border width 


de.w 0 3 border colour (black) 
de.w 7 3 paper colour (white) 


Again, there is nothing remarkably difficult here. Bit 7 of the first byte tells WMAN whether or not the 
window is to be cleared. Setting bit 7 says that the window must not be cleared. Following on, we 
define a shadow size for the bottom and right edges of our window. 
Remembering back to our initial forays into the raw Pointer Environment, you may remember that we 
could have a different shadow depth on both of those sides, using WMAN, it appears that the shadow 
must be the same down each side. Oh well 
Note: The documentation says that for sub-windows the shadow depth should be zero. Best we stick 
to that advice. Remember, a sub-window is one ‘embedded’ within the main window. See application 
sub-windows or information sub-windows above. 
Next, and finally for the main window, we have the definition of where the default pointer sprite for the 
window is to be found. 

de.w 0 3 use default pointer 


This is one of my changes. In a need to reduce the amount of code in the magazine and also, to 
reduce your typing, I've modified Oliver's definition to use the default arrow pointer in the main window 
and in the application sub-window which will be defined below. Oliver had a custom sprite for the main 
window and another for the application sub-window. Both have been removed. The original file had 
this definition (don’t type this in!) and a chunk of code to define the sprite to be used. 


3 DO NOT TYPE THIS IN! 
de.w sprt-* 3 pointer to pointer sprite 


You should be aware that all pointers in a window definition are word sized and relative to their own 
position in the definition block. 

Now, that implies that all object lists must be within plus or minus 16KB of the pointer position, which 
might be a problem when there are a lot of objects and so on to define. To this end, if bit zero is set - 
an odd address - then that offset is used as a pointer to a long word which itself is a relative pointer 
to the object in question. Obviously, the word length odd pointer obviously has to be made even first, 
this is done simply by clearing bit zero. 

In the above, if the Pointer Sprite above was defined a long long way away, we would see something 
like this: 


de.w sprt~—*+1 3 ODD Pointer to a long pointer to 
3 our window's pointer sprite. 


spr t dc.1 Real_sprt~* 3 Long pointer to pointer sprite. 
Real_sprt eee 3 Pointer sprite definition. 


If any pointer is to something we don't need, then simply set it to zero. So, for example, instead of 
using Oliver's original '?’ sprite (shaped like a question mark) we have defined this word pointer as 
zero and get the default arrow sprite instead. In this case, zero means ‘use the default’ but in other 
places, it means ‘not used’ 
Next to be defined are the attributes for all the loose items we will be using in the window. Starting 
with the easy bits: 
3; Menu item attributes 

de.w 1 ; Current item border width 

de.w 0 ; Border colour (black) 


As before, it is simple. We define a black border 1 pixel in width. When the pointer is over any of our 
loose items, this border will be drawn around it to indicate that ‘you can do something here’. 

Following the border, we have the attributes for the loose items that are unavailable, available and 
selected. These attributes require 8 bytes each and define paper and ink (for text objects contained 
within them) and also blobs and patterns for the other object types. We are only using the paper and 
ink attributes, but the others must be there. We use zero to indicate ‘not in use’. 
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3; Menu item unavailable 


de.w 30 ; Paper colour (green/white stipple) 
de.w 30 3; Ink colour 

de.w OQ 3; Pointer to blob for pattern 

de.w 0 3 Pointer to pattern for blob 


; Menu item available 


de.w 7 Paper colour (white) 


3 
de.w 0 3 Ink colour (black) 
de.w 0O 3 Pointer to blob for pattern 
de.w 0 3 Pointer to pattern for blob 


; Menu item selected 


de.w 4 3; Paper colour (green) 

de.w 0 3; Ink colour (black) 

de.w 0 3 Pointer to blob for pattern 
de.w 0 3 Pointer to pattern for blob 


In this example program, the loose items are never anything except available (and very briefly, selec- 
ted) so the unavailable attributes are never used, but they still have to be defined. Oliver has chosen 
to use a paper and ink colour of 30 for unavailable loose items. That value gives a pleasant green/ 
white stipple. Don't worry about it because you will never see it! 
Following the loose item attributes, we have a relative pointer to the help window. In this program, we 
are not using one, so that pointer gets the value of zero. 

de.w 0 3; Pointer to help window 


That is the end of the fixed part of the window definition. So far so good, there has been 
nothing too difficult yet. | wonder what is coming? 

The rest of the definition block defines the repeating parts of the window definition. What exactly 
does that mean? 

The documentation has this to say about the repeating parts: 

To allow for a variety of different layouts within the window as the size of the window varies, part of 
the window definition may be repeated several times. The definition should be made in order of 
decreasing window size. The last definition which defines the smallest allowable window, should be 
followed by a word containing -1. If the top nibble of a layout size word is zero, then the layout may not 
be scaled. If it is %0100 then it may [be scaled]. 

So there you have it. The fixed part of the window defines the default layout for the window. That 
layout and all other possible ones allowed, need to be defined in the repeating part of the window 
definition. 

A window can be scaled by WMAN if the definition allows for it. The scaling flag is the top nibble (4 
bits) of the size words for the window layout. If the top nibble is %0000 then it cannot be scaled and if 
it is %0100 then it may be scaled. 

Note: This actually shows up what | think is a contradiction in the documentation. There are other 
values that can be used in the top nibble, not only %0000 and %0100. More on scaling later in the 
series. 

scaling applies separately to the width and to the height of the different layouts. You don't have to 
scale vertically and horizontally, you can pick one, the other or both as desired. 

For simplicity, and because | have not investigated scaling yet, Oliver and | will be sticking to 
non-scaled windows for now. Scaling will be a subject for a future article. 

The following is the repeating parts for our single, non-scaling layout in our small program. 

3 Base of repeated part of window definition 


de.w 160 ; Width for this layout 

de.w 84 3; Height for this layout 
3 Pointers to definition lists 

de.w il-* 3; Information sub-windows 

de.w 11-* ; Loose menu items 


de.w al-* 3; Application sub-windows 


The above would be repeated for each and every different allowable layout for the window. Following 
on from the very last layout, the smallest allowed, we have the terminating word. 
de.w -1 3; End flag 


So we allow one and only one layout, which just happens to be exactly the same size as the default 
one defined in the fixed part of the definition block. It has three pointers at the end for the information 
sub-windows, the loose items and any application sub-windows that are required in this layout. Each 
layout will have it's own list and they need not be the same for each different layout. 

We shall pause for breath at this point and discuss these lists in the next article. Hopefully, the above 
was not too taxing and I've explained it better that | ever had it explained to me! 

Next time, we continue our look at the window definition by looking into the lists of objects attached to 
our window. 
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It seems that most people find writing programs 
for the Pointer Environment (PE) fairly, if not ex- 
tremely, difficult. Probably the two main difficulties 
are understanding and producing a Window Defi- 
nition, which lies at the base of all PE programs, 
and understanding how the PE software works. 
There are various programs designed to help 
programmers. For those writing in S*BASIC there 
are EasyPTR and TurboPTR. | exclude the Super- 
BASIC version of QPTR because that does not 
rely on a Window Definition. For C programmers 
there is CPTR. For assembler programmers there 
is the set of macros in QPTR, written for the 
assembler Qmac, which help in producing a 
Window Definition suitable for assembly as 
relocatable code needing linking with other 
modules to produce the final executable program 
| will now describe another way of helping as- 
sembly programmers. This is called EasyPEasy 
short for Easy PE Assembly. This is available on 
my website at 

web.ukonline.co.uk/george.gwilt 


The help given by this goes beyond that in the 
QPTR macros. A further difference is that the re- 
sulting source code can be assembled by either 
GWASL or GWASS without the need for linking. 
The files included in EasyPEasy comprise Keys, 
Sprites, Subroutines, Examples and an explana- 
tion, or guide, in Readme. 

An extract from the guide is given here: 


* Start of Extract * 

This guide to writing PE programs using Assem- 
bly Language contains the following sections: 

A - Short Description of PE 

B - PE Windows 

C - Program structure 

D - Files provided 


be 


A - Short Description of PE 

The Pointer Environment (PE) consists of two 
parts, PTR_GEN and WMAN. The first of these is 
a CON/SCR driver which contains many extra 
Trap #3 routines. 

The second is a set of vectored routines based 
on the new Trap #3 routines enabling a program- 
mer to operate windows in a PE program. 

A PE program is operated by means of a pointer, 
usually by means of a mouse. 


B - PE Windows 

At the basis of all PE programs is the Window 
Definition. This contains details of all the possible 
windows which can be used inside a program. 
The definition starts with a fixed section detailing 
amongst other things the maximum window size, 
its border size and colour and its paper colour 
This section also has a pointer to the sprite to 
be used as its pointer. 

The fixed section is immediately followed by a 
set of at least one repeated sections. Each of 
these has a size which must be less in at least 
one dimension than that of the previous section 
and must not be larger than the maximum size in 
the fixed section. Each repeated section has 
pointers (which may be null) to lists of loose 
items, information windows and application win- 
dows. 

The loose item list consists of a set of sections 
which detail the size, position and type of item 
(for example text or sprite). Each item also con- 
tains a pointer to its action routine. 

Similar information is given in the lists of infor- 
mation windows and application windows, though 
for the former there are no action routines. 
Associated with the window definition is the 


64-byte status area which is immediately fol- 
lowed by a set of bytes, one for each loose item, 
which constitutes the loose item status block. 


C - Program Structure 
The following flow chart shows the structure of a 
simple PE program. 
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D - Files Provided 
To help in the production of PE programs a 
number of files are provided. They are: 


A. KEYS 

keys_pe keys for PE Trap #3 routines keys_wdef 
keys for the window definition keys_wman 
values of WMAN vectored routines keys_wstatus 
keys for the status area keys_wwork keys for 
the working definition qdos_pt pointer interface 
keys 


B. SPRITES 

The sprites given here are system sprites for 
mode 4 as well as a few extra sprites, such as 
the hand sprite, for all modes. 

csprc_bin sprites which can be LIBd 
csprc_sym_lIst the names of sprites in csprc_bin 


C. SUBROUTINES 

peas_bin subroutines to be LIBd peas_sym_lst 
names of subroutines in peas_bin 

The subroutines are defined here: 


GETSP returns in AO the address of an area of 
DiL bytes. If there is an error the program 
commits suicide. 

No other registers are used. 


MOVE causes a move, then clears D4 and DO. No 
other registers are used. 


RECHP returns to the heap the area with base 
address in A4. No registers are used. 


SET_AP sets an application window menu 
At entry: 

DiW = Number of items 

D2W = Number of bytes between items 
A0 > Items 

Al > application window 

A4 » working definition 

No registers are used 


SLEEP sets the program to a button which 
contains the name of the program and is placed 
in the button frame if there is one or at the top 
left of the screen if there isn't. A HIT (left click or 
SPACE) will cause the program to waken. A DO 
(right click or ENTER) will cause the program to 
waken if there is a button frame or causes a 
move if not. This enables a user to set buttons at 
different places on the screen if there is no 
button frame. 

At entry: 

DiL = size needed for the button (ww0_1) 

D2.L = size for main window (ww0_0) 

A2 = WM vector A4 ~ working definition 

On exit: 

Di-3 are used AQ = channel ID 

Al is used 

A2 = WM vector 

A3 = Window definition 

A4 ~» working definition (may have changed) 


SU! quits 


D EXAMPLES 

Seven examples are given, Ex0 to Ex7 excluding 
Ex5. For each example there are three files, the 
source code (_asm), the window definition 
(w_asm) and the assembled executable program 
(_bin). Thus the files for ExO are ExO_asm, 
ExOw_asm and Ex0_bin. Each program shows 
some aspect of PE programming. 


Ex0 shows four common operations move, 
resize, sleep and quit. 


Ext shows how to set up the menu of an 
application window from the directory of flot. It 
also shows how to cause a sleep by CTRL/F1 
without a corresponding loose item. 


Ex2 shows a how to set a secondary window. 
Items in that window can be selected. A right 
Click in the area containing the items (but not on 
an item) causes the first window to reappear. 
Clicking Print will now print the items selected. 
This window can be set to a button by pressing 
CTRL/F1. 


Ex3 shows drawing on the screen. Clicking OFF 
or pressing O allows drawing. The colour can be 
changed by pressing W, G, R or B. The display is 
cleared by pressing C (even when Clear is ‘not 
available’), Drawing ceases on a right Click, 
pressing ENTER or O. This program does not go 
to sleep on pressing CTRL/F1. 


Ex4 shows how to drag an object inside an area. 
Holding down the left mouse key causes the 
pointer to disappear and allows dragging until the 
mouse key is raised. 


Ex6 shows how small explanatory windows can 
appear if the pointer is left on a loose item for a 
sufficient period of time. This program can be 
buttonised by CTRL/F1. 


I'm one of those who still use their QL (actually 
QPC) every day or so. Indeed, I've written a 
,ousiness suite’ which allows me to keep track of 
my cases, and which also handles the (very 
modest, see below) accounting needs of our 
office. | don't pretend to have written something 
revolutionary or particularly well done. It's just 
that the software is tailored exactly to our needs 
and to my way of working. It's thus understand- 


Ex7 shows the resizing of a secondary window. 
This is not exactly the same as resizing the 
primary window. 

Note that all examples can be assembled by 
GWASL as well as by GWASS. QPTR 


* End of extract * 


Window Definition 

None of the files in EasyPEasy help to produce 
the Window Definition. How then should a pro- 
grammer produce this? One way is by ‘direct 
generation’ as the manual for QPTR calls it. That 
is by setting the numerical values to a set of 
DCW instructions. However, when it comes to 
producing the Window Working Definition, it is 
necessary to know the amount of space requi- 
red. This can, laboriously, be calculated from the 
Window Definition but it is advantageous to have 
some better method of finding this. The macros 
of QPTR do it. Another way is to use SETW. 
SETW is a program which produces Window 
Definitions for assembler use. 

It may appear easier to prepare a window defini- 
tion without the use of a program whose opera- 
tion may not be immediately obvious and so has 
to be learnt. But SETW has certain advantages 
which should not be overlooked. 

1. The sizes of working definitions are provided. 
2. The definitions of text items are provided. 

3. All system sprites and a few others are provided. 
4 The windows produced are viable. 


The last advantage will certainly be appreciated 
by anyone who has attempted to produce a 
window definition without the help of a program 
such as SETW. The chance of a window being 
accepted first time by the PE software is remote. 
When something goes wrong the message ‘out 
of range’ is peculiarly unhelpful since it may refer 
to any of the large number of constituents of the 
window. 


able that I'm pretty loathed to give it up and use 
some PC software that an outside firm is trying 
to push onto our office. Since | determine what 
software our office uses for anything common to 
all of us, that switch hasn't happened, at least 
until recently. However, cost factors have caused 
me to rethink my strategy. 


To explain how this came about, a small word of 
how out accounting is handled here. Like anyone 
self-employed, we have to have accounting 
books, double entries, ledgers and tutti quanti. 
This actually can take up quite some time that | 
could usefully spend on something more worth- 
while (like doing some QLing). Moreover, ac- 
counting regulations change over time and | don't 
really fancy having to keep up with something 
like that every day. So we use the services of an 
accounting firm (which is attached to our bar and 
thus has competitive prices). We supply it with 
raw data, consisting of a day-to-day record of 
what money was paid/received where and for 
what, and that firm then generates all the correct 
books in the correct format. It also automatically 
handles depreciation and write-off of our equip- 
ment, formally audits the books and thus our ac- 
counting and also certifies it. The certification 
entitles us to a 10% reduction of taxable income. 
SO you could say that apart from our recording 
the every day flux of incoming and outgoing 
funds, our Own accounting needs are pretty slim, 
since more or less everything else is handled by 
the accounting firm. My own accounting program 
is of course tailored to that and generates a 
(monthly) report for the accounting firm with the 
required information. It also handles some other 
queries and data (e.g. what is the financial status 
of a case, which partner generated what kind of 
income etc..) which aren't strictly necessary for 
accounting purposes only, but are necessary (or 
at least useful) for our office. 

Anyway, for the formal accounting, | thus gene- 
rate a report that is sent to the accounting firm. 
The accounting firm takes that information and 
turns it into the correct books etc. Up until last 
year, the way | sent this information was ..{ahem)... 
on paper Yes, strange as it may seem, | typed 
that info into my computer, and then printed it and 
sent the printed sheet to the accountants. They 
then retyped this information (!) and did what they 
had to do with it. Several years ago | thought that 
this was a pretty stupid way of doing things, after 
all | already had this information electronically 
why could | not send this to them electronically? 
So | inquired after that and was informed that this 
was, of course, possible - but to do that | would 
have to use their own accounting program run- 
ning on a PC. 

Of course, that was a no-no for me, though | was 
told that, for retyping the data, they actually had 
it retyped in India (!), so they probably scanned 
the pages | sent them and emailed them to India. 
Pretty inefficient if you ask me.. Anyway, not to 
be deterred | inquired further and it turned out 


that | didn't really have to use their software, ‘all’ 
that was required was that | send them the infor- 
mation in exactly the same format as that used 
by their own software. OK, so let me have the 
specifications for that, | asked - after all there 
must be many who, like me, use another program 
than the one sold by the accountants. This 
actually was confirmed to me (apparently, many 
used a simple Excel datasheet for the day-to-day 
records}. | was promised that | could have the 
specifications, and ... | really got them. | reckoned 
that with these specifications | could generate, 
from within the QL, the information in the correct 
format. | was wrong. Have you ever read specifi- 
cations that were drawn up specifically so that 
they are NOT understandable? Well, here | had a 
perfect example of something like that. It was 
quite clear that these specifications were set out 
in such a way as to require so much study just 
to understand them as to make the effort simply 
not worth the while. So | just abandoned that idea 
and kept sending my information on paper. 

Of course, this couldn't continue forever, even the 
accounting firm noticed that this was an ineffi- 
cient and (for them) costly way of doing things. 
SO, to get to the die-hards like me, what they did 
was to increase the (yearly) prices for the ‘paper’ 
version of their services whilst decreasing those 
for the (yearly) software version thereof. For a 
few years | just gritted my teeth and paid the in- 
creased prices only because | wanted to be able 
to continue using my software which, as | said 
earlier is exactly tailored to our needs and way 
of working. However, after a few years, the price 
differential between the “paper” version and the 
software version became just too important - 
were talking about several hundred euros a year 
here, and even if youre used to a certain way of 
doing things, if it becomes that uneconomical, 
you just have to amend your ways. 

So, last year | decided to bite the bullet and get 
their software. After all, | presumed it would be 
OK and have more or less all of the functions I'd 
need. Oh boy, was | wrong. 

As soon as the very nice lady from the accoun- 
tants came to train me on the use of the soft- 
ware (all of a few hours worth) | smelled disaster: | 
was faced with a totally rigid interface having 
only the most basic of functions and obviously 
bolted on to something right out of DOS times. | 
know that we lawyers are often a pretty back- 
ward and conservative bunch, but here | had met 
my masters. Shudder An example: in the (mo- 
dern} PC world, when you want to delete some- 
thing in a field or a control, you just mark 
(highlight) it with the mouse and then hit delete. 


You can't here. You have to delete every single 
character Re-shudder. 

There was just no way | was going to use that. 
So what to do? | thought that there had to be 
some way to get the information from my QL into 
the accounting software, but how? At the same 
time as this happened, I'd also started to have a 
look at "Java", a modern programming language 
of the object oriented kind, and | thought that | 
might be able to knock something up with that. 
But what? 

As an aside: Opinions about Java vary enor- 
mously, it has the (often undeserved) reputation 
of being very slow. | don't really want to go into 
that debate here. | find it an elegant language 
with one advantage: it is pretty safe and leads 
you to write programs that have fewer bugs from 
the onset. To my mind, that is a great advantage. 
However, Java is also a language that isn't really 
close to the machine - there is, for example no 
way to set the screen resolution from within a 
Java program. 

Anyway, | really didn't want to have to re-dig 
through the specifications for the accounting 
program to see whether | could generate from 
the QL a file as if it was generated by the ac- 
counting program, so | had to find a way of get- 
ting my information directly from the QL side into 
the accounting program. | lucked out there: Java 
has a ‘robot’ class. (For those who don't know 
object oriented programming, a class is a self- 
contained set of program routines and data that 
are supposed to the entirely reusable). The ‘ro- 
bot’ class enables you to simulate mouse clicks 
and keyboard hits. You can thus tell it to put the 
mouse cursor at a certain point of the screen. 
You can also tell it to simulate a right or left 
mouse click (mouse button pressed and mouse 
button released). You can also direct it to simu- 
late a keyboard hit — it will thus insert a character 
into whatever field or control has the keyboard 
focus. 

OK knowing that, the whole exercise became 
pretty simple in theory: the program would 
simulate me. It would read the data from a file that 
is generated from the QL side of things and input 
it into the accounting program's form as if I'd 
typed it in. | thus amended my QL accounting 
program so that it printed the information no 
longer to a printer but to a file, which is always 
called *c:\main_int_storagetxt’. (No, don't ask me 
how | came up with that name, | have no recollec- 
tion of it) So | always send the QL accounting 
report to that file. 

This information is in a very simple structure : it is 
subdivided into "records’, each record being just 


one transaction (money paid or received). Each 
record starts with the words ‘**RECORD 
START**" and ends with the words ***RECORD 
END**", Each record contains the same kind of 
“fields” : first the "PCG" number. The PCG is the 
general accounting plan - each transaction is 
posted to a determined account identified by that 
number (PCG code). Then the record contains 
the date of the transaction, the amount with and 
without VAT, the title of the transaction (eg. 
Paper’ if | bought reams of paper) etc. Each field 
in turn is introduced by a label, such as 
“*KDATE**” for the date, or "**SORTIE**’ if the 
money went out of our pockets and 
"KENTREE**" if it came into them (| should 
probably have done it differently and generated 
XML tags). All of the data is in simple ASCII text. 
Thus, this is a pretty simple text file of a clearly 
defined format. This text file is then read in by the 
Java program which does some basic checking 
(more of this later) and inputs the data into the 
accounting program. 

| don't know whether the editor will include the 
listing of the Java program here - | don't pretend 
that it is an example of good programming. 
Indeed, when | went back to it to have a look at it 
for the purpose of preparing this article, | wasn't 
surprised to read that | had commented it as "this 
is a pretty awful hack’. | wrote it rather quickly, 
pretty inefficiently and not very elegantly - | ne- 
ver really went back to improve it, once some- 
thing worked. However, it seems pretty bug free 
and does what | want - and | can't really be 
bothered to change something that works. It is 
called, fittingly but unimaginatively, ‘Inputter’. 
Developing "Inputter’ wasn't too difficult. | used 
an IDE (integrated Development Environment) 
called NetBeans IDE. This provides you with a 
development area where you can draw the 
window of your application-to-be, put the buttons 
into it and then write the code that is supposed 
to happen when the user pushes the buttons. It 
also allows you to run the program, set break- 
points in it, inspect variables etc. (something like 
that is REALLY missing in the QL World). Again, | 
don't want to discuss the merits or not of 
NetBeans as compared to other IDEs such as 
Eclipse etc. It just happens to be what | used and 
you will find some evidence of that in the code of 
the Java program as the environment generates 
some code itself (As an aside, | even know 
people who always write their Java code within 
a simple text editor - one of these is one of the 
best professional programmers | know!). 

When the Inputter program is started, it shows 
just three buttons: “Start Aidavocat’ (executes 


the accounting program), ‘Load data” and ‘Insert 
data’. These three buttons are supposed to be 
pushed one after the other and actually show 
how the program itself was developed. 
Indeed, first of all, | tried to find out whether from 
within a Java program | could actually start up 
another program, or whether | would have to 
start the accounting program first and then my 
program. Java provides a ‘runtime’ class 
however, which allows you to execute another 
program. The line 
"p=r.exec(comptaDir+"AIDAVOCAT. exe"+ 
comptaDir+"Aidavocat.1br")" 
calls up the “Aidvacoat.exe” accounting program 
and passes it "Aidavocatlbr’ (its accounting data- 
base) as a parameter. 
So, once this is done, the accounting program is 
set up and running. Then | push the next button 
of the ‘Inputter’ program - this loads the QL 
generated data into the Inputter program. Nothing 
fancy here, on the contrary, it is all pretty unspec- 
tacular and dull and not very efficient. The proce- 
dure “file_io.open’ first of all tries to open and 
read a file called “comptes_existantstxt’ (= 
existing accounts). This is a simple text file 
containing all of the PCG codes the program 
should know about. 
This deserves some explanation: As mentioned 
earlier, each account in the general accounting 
plan (PCG) is identified by a number code. Most 
of these are pretty standard and all accounting 
programs must know about them, and do. 
However, you are also allowed to create your 
own sub-account numbers, within this framework. 
For example, account number 760000 generally 
identifies fees received with a normal VAT rate. 
Within that account, | can create more sub- 
accounts, such as 760001 - fees received by me, 
760002 - fees received by another partner etc... 
Of course, my QL accounting program "knows’ all 
about these sub-accounts, but the other ac- 
counting program didn't know about them at first. 
So | had to create these sub-accounts first in the 
PC accounting program. This is pretty normal 
and has nothing to do with the awkward handling 
of the accounting firm's program, you have to 
teach every accounting program the quirks of 
your own firm. 
lf you attempt to introduce a transaction with an 
(as yet) unknown account number such as 
760001, then the accounting program complains, 
as it should. No accounting program can create 
those sub-accounts all by itself it needs your 
input for that creation. SO when you try to use 
an unknown account, the program has to 
complain. This complaint is materialized, in this 
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case, by a window that pops up and tells you 
that the account you are trying to use is 
unknown. Again, this is as it should be. However, 
in an automated system such as mine, where the 
computer fills in all of the fields, such a new 
window will play havoc with the inputting, since 
the Inputter doesn't know about this new window 
and cheerfully tries to fill in fields that are no 
longer accessible. To avoid that, | keep a simple 
text file with a list of account numbers the ac- 
counting program already knows about. This list 
is read by the Inputter program. Then, for each 
record in the QL file read by Inputter it checks 
the PCG number of the transaction against the 
known PCG numbers. If the PCG code of the 
transaction is NOT known (and thus as yet un- 
known to the accounting program), then Inputter 
doesn't even try to input this record. It sets it 
aside, and once it has finished, it writes all of the 
unknown records out into a log file called 
“c:\main_int_storage2txt’. More of this later. 

lf the PCG is known and the record seems OK, 
Inputter keeps the respective information inside a 
very simple array. At the end of the reading 
process, it has one array with all records that are 
to be input into the accounting program and one 
array with the unknown records. 

The third button actually causes Inputter to do 
the inputting work. First of all, it brings the 
accounting program to the front of the screen. 
The accounting program always takes up the 
entire screen when it starts up. So | put the 
mouse at screen co-ordinates (0,0) and “click” - 
this causes the accounting program to come to 
the front, just like a program lying behind another 
one pops to the front when you click on It. From 
now on, every mouse Click and keyboard tap will 
happen inside the accounting program. After that, 
Inputter clicks on some buttons inside the ac- 
counting program, to bring up the input form to 
be used. Again, this is done by putting the 
mouse cursor at the screen co-ordinates where 
the respective buttons for this can be found in 
the accounting program. Since the accounting 
program always takes up the entire screen and 
since | run this at a determined screen resolution, 
the location of these buttons never changes. | 
used a freeware program (| cant remember 
which one) to find out the exact positions of the 
buttons. This position is simply programmed into 
Inputter itself. 

Now | put the mouse cursor simply smack in the 
middle of each button and “click” on it. Once the 
input form is up, the program takes each record 
in turn, and inputs the information into the form. 
This is done by clicking into each field, cumber- 


somely deleting everything in there (by repeated- 
ly pressing and releasing the “delete” key) and 
inserting the new data. At the end of the record, 
Inputter “clicks” on the ‘validate’ button to accept 
this entry and starts over with the next record. 
Once it's finished inputting all of the data, Inputter 
brings itself to the front of the screen and tells 
me how many records it input. This allows me to 
see at a glance whether all of the records saved 
by my QL program were input into the accoun- 
ting program (the QL program tells me how many 
records it wrote out). If necessary, | check with 
the ‘c\main_int_storage2txt’ log file to see what 
went wrong. Mostly this is simply that | used a 
sub-account the PC accounting program didn't 
know about. - it is astonishing how many sub- 
accounts | have created over the years in the QL 
program. Once | have identified the accounts the 
PC accounting program doesn't know about, | 
create them in it, rename ‘c:\main_int_storage2 txt’ 
to ‘c\main_int_storagetxt’ (ie. the normal input 
file for Inputter) and rerun Inputter so that it fini- 
shes inputting the information from that file into 
the accounting program, too. For that, the log file 
has exactly the same format as the normal input 
file.. Needless to say, nowadays, where | have 
been using this system for over a year the 
number of unknown PCG codes has decreased 
dramatically, so most of the time, the program 
runs without a hitch. 

| generally let Inputter run when Im doing some- 
thing else somewhere else. Indeed, whilst Input- 
ter is running, you can't use the computer for 
anything else since the program is steering the 
mouse and inputting characters. It clicks at a 
certain place on the screen without knowing 
what is underneath. So if you open another pro- 


gram over the one where the input is supposed 
to go, the input will go into that newly opened 
program, which definitely isn't what you want. 
Hence also a word of warning: if you ever intend 
to use something similar make a large number of 
test runs with very few (but different) data during 
each run: it is nearly impossible to stop the Java 
program whilst it is inputting data, since the 
mouse moves all over the screen and characters 
magically appear Even the three fingered salute 
(Ctrl-Alt-Del) which brings up the task manager 
under Windows is dangerous, since you could 
inadvertently close down all kinds of programs 
with it as Inputter will cheerily click in it if it hap- 
pens to have its window at a place Inputter is 
supposed to Click... 

Once the process is finished, | have input my 
data into the PC accounting program and can 
send it fo the accounting firm. All in all, I'm pretty 
happy with the solution | found - | pay less 
money but still use my old QL program, whilst 
giving the accountants what they want. 

PS. as a final word, if you look at the code you 
will see some references to Linux. | actually 
wrote ‘Inputter’ under Windows. When | ran it 
under Linux (the PC accounting application then 
ran under “Wine’), | notice that a mouse click ona 
certain screen position didn't click at the same 
place in the form... Grrr... I'll have to investigate 
and probably just change the entire button 
emplacement data. QL forever! 

[Editors note: we have started laying out the 
program. It was soon clear, that it would fill 
many pages, even in very small print (8pt or 
smaller) so we thought, we'd rather put it onto 
the qltoday website and on the next cover disk. 
If you want us to print it, please let us know..] 


Mikael Strom has written a viewer to display 


Quill_doc files in non QL operating systems. In his 
own words: 


‘Quill View was written because | got tired of 
firing up QL2K every time | needed to read a Quill 
document. Writing the code was more compli- 
cated than anticipated, and there are still a few 
things that need to be done. However it now 
properly formats all documents that | use’ 


QL Today received its copy of Quill View too late 
to be included in the main news section (the 
editor's fault and not Mikael's), and we only have 
time and space for a short review We would 


welcome a more thorough review from any 
reader who is interested. 


Quil-View currently runs on Windows XP and 
Vista, QL/QDOS, Debian 4,Ubuntu 8 and Fedora 3 
through 9 (and Red Hat). 


QL Today received Its copy of the program as a 
Zip file containing versions for several different 
operating systems and documentation in 


Quill_doc, HTML and text formats. It is not neces- 
sary to install the program on a PC. | expanded 
the zip file to a stick memory and the Quill 
Viewexe application was ready to use. 


File and Folder Tasks 


? Make anew folder 
&@ Publish this folder to the 
Web 


are this. folder 


quilbyiew: 

My Documents 
Shared Cidcuments 
My Computer 

My Metwork Places 


and these were 
correctly 
transferred. 
There are one or 
two Quill features 
that are not sup- 
ported such as 
soft hyphens, but 
these are often 
not supported in 
other transfer 
programs. 


At the moment 
Quill View is still 
being developed, 
but the — latest 
(beta?) — version 
can be down- 
loaded from a 
special Quill View 
page on Jimmy 


To test the program | used material | had written 
to test QL-2-PC Transfer All | had to do was to 
transfer a Quill_doc file to a PC medium, and then 
drag and drop it to the Quill-View icon and click. 
The text is then displayed in the default browser. 
Below you can see the original Quill document 
and the browser text. 


es TE ee 
GL-2-PC TRANSFER 


C TRA 


If you press Alt at the same 
time as you drag and drop the 
document is automatically loa- 
ded into notepad or whatever 
program you use for displaying 
text files. (Notepad is not very 
useful as it does not support 
all of Quills formatting.) 


| also tested a Quill file con- 
taining accented characters 


Montesinos' — ja- 
diam site. 


http://www.jadiam.org/ QL2K/ QuillView 


Jimmy also informs us that he has now released 
QL2K Build 101. This version enhances Vista 
support and is available in 32 and 64 bit editions. 
There is also improved sound 
support. There is also a new 
version of QLAYT. 


Jadiam is Jimmy's company 
and this has just opened a new 
corporate website. At the mo- 
ment the non-QL areas of the 
Site are only in French. 


To the left, the document as dis- 
played in Quill, below the result of 
Quill-View. 


Old Favourites! 


Utilities 
SBASIC / SuperBASIC Reference Manual on CD £ 20.00 
Sidewriter v1.08 £10.00 i 
Landscape Printing (EPSON printers) 
ImageD v1.03 £10.00 
3D object generator 

** We have moved ** Q-Help v1.06 £ 10.00 

See our updated address details below. aan iaeae pias help system £ 5.00 


We have also acquired more brand new Sinclair QL membranes and another stock of 


Epson Stylus Colour 850 inkjet printers, so if you need a better printer for your QL, Keyword-to-topic finder 


give us a shout. ProForma ESC/P2 Drivers v1.04 for ProWeSs £ 8.00 
Printer Driver 
More news is always available on our website: www.rwapsoftware.co.uk 
Applications 
We are also locking to produce some new hard disk interfaces for the ZX Spectrum 
and have a few little projects on the drawing board. 
mm : Flashback SE v2.03 (upgrade only) £ 5.00 
| Our websites: Database 
http://www. rwapservices.co.uk (General site) 
http: //www.rwapsoftware.co.uk (Sinclair computer second hand and new items} QL Cash Trader v3.7 £ 5.00 
| http://www.rwapadventures.com (Adventure Programs) Accounting/Finance 
| http://www. internetbusinessangels.com (Guidance on setting up online businesses). QL Payroll v3.5 £ 5.00 
Accounting/Finance 
ce ELC LCL nt QL Genealogist v3.26 £ 20.00 
Genealogy 
! Genealogy for Windows £ 50.00 
New Products! QL Genealogist to Windows version upgrade £ 25.00 
QL Cosmos v2.04 £ 5.00 


Planetarium 
me — ay Gilly 
RID! g g NOW With! DIGITAL Q-Route v2.00 £ 25.00 


wontons Be Be SOUN iD) ON @PCAI Route Finding 
iti a ; inf ; Upgrade from v1.xx £ 5.00 
The wait is now over! Q-Word version 1 is finally available! Britain map v1.11 $2308 
BIG Britain map (needs 2Mb) v2.03 £ 5.00 
Platforms: Various Britain Area maps (ask for details) ea. £ 2.00 
QPC/QXL, Q40/Q60, Aurora (with SGC) ireland map v1.00 £ 5.00 
Belgium map v1.01 £ 2.00 
Prices: Catalonia map v1.03 £ 2,00 
P-Word UK English Dictionary (500.000 words!) £15.00 
All versions without P-Word £20.00 Dictionary 
All versions with P-Word £30.00 a 
Leisure 
Notes: 
Q-Word DOES NOT require SMSQ/E with GD2 support -OR- SMSQ/E atall on Return to Eden v3.08 £10.00 
the Aurora or Qx0 machines. It works on the highest colour depth everywhere Adventure 
regardless of Operating System. Nemesis MkII v2.03 £ 8.00 
The Aurora version is available on either HD or ED disk. For the latter add Adventure 
£1.00 to the price. ED version is uncompressed and can be run directly from The Prawn v2.01 £ 8.00 
the floppy. Ali other Fioppy versions are compressed. QPC/QXL version Adventure 
comes on CD. Non CD versions DO NOW support digital sound on QPC2 Horrorday v3.1 £ 8.00 
ne Adventure 
West v2.00 £ 5.00 
Adventure 
The Lost Kingdom of Zkul v2.01 £ 5.00 
: vee : Adventure 
For QLers that run Windows or with incompatible hardware for ANG 
games above £25.00 
Talent Games, we now have re-released these adventures so that 
they can run on your Windows-equipped PC. No Emulator, D-Day MkII v3.04 © 10.00 
floppies, microdrive backups etc. required, just a one-click install! Strategy/War Simulation 
Of course the full QL line is still available! (See side column) Grey Wolf v1.08 £ 8.00 
Graphical Submarine Simulation 
Talent Games for Windows ea. £ 10.00 War in the East MkIl v1.24 (upgrade only) £ 5.00 
(Each Game includes a runtime installation of QLAY-2 by Jimmy Montesinos) Strategy/War Simulation 
Games Currently Available from www.rwapadventures.com Open Golf v5.20 £ 8.00 i 
The Lost Kingdom of Zkul Sports Simulation 
West QuizMaster }) v2.07 £ 5.00 
The Prawn Quiz 
bsicaehaclased Stone Raider Il v2.00 £ 5.00 


Arcade Game 
Hoverzone v1.2 £ 5.00 
Arcade Game 


Replacement Sinclair QL Keyboard Membranes 


We always have a stock of brand new Keyboard Membranes (and keyboard parts) 
for the original Sinclair QL, so if you have some keys which no longer work, just 


give us a call, Deathstrike v1.5 £ 5.00 
Arcade Game 
Cost is only £18.50 plus £2.75 t and king. a 
padicanatiel! cto ited aaa Flightdeck v1.0 £ 10.00 
Second Hand Items - Huge Range Available Fi a Simulation ' ' KS 
i We stock a wide range of books, hardware and software for the Sinclair QL, Z88 and 16 games above (Open Go f, QuizMaster Stone 
ZX Spectrum, including disk interfaces, memory expansion and microdrive cartridges. Raider Il, Hoverzone, Deathstrike and Flightdeck) £ 28.00 | 
If there is anything you need ~ have a look at www.rwapsoftware.co.uk (or ring us 
ith detail i ts}. . 
eth, details. of your reaulr ements) Notes on Software requirements 
: We are always happy to help. The following programs have a minimum SGC card requirement: P-Word, 


Qword, Big Britain MAP for Q-Route 


RIVAP Services 


3 Date View Court, Fulford, Stoke-On-Trent, Staffordshire ST11 OBA TEL: (+44) 1782 398143 From the UK Dial: 01782 398143 
Website: http://www .rwapsoftware.co.uk 
Emait: sales@rwapsoftware.co.uk 


We Accept Payment using: 


PayPa 


(Cheques in £ sterling made payable to R. Mellor) 


As announced in the previous issue of QL Today, 
QMENU Version 8 exists and has been shipped 
to everybody who ordered it. 

Actually, it is V801 now and a new section 
QMENU Version 8 has been added to the JMS 
Update site for all the users who upgraded to V8 
(| hope | have not missed any). 

Of course, customers without a login ID have no 
access to their updates, so if you are NOT 
registered, please send me the login ID you 
would prefer and your password, and | will set up 
an account for you. 

This service is free of charge, so why not use it? 
Which reminds me to say ‘Thank you’ to Bruce 
for hosting this service! 


For users who have not upgraded | have left the 
update download possibility to download the last 
version 7 (it was 7.68, created at Eindhoven in 
Summer 2008). 


If you wish to place an Upgrade order to Version 
8, you can do it through the SMSQ homepage of 
J-M-S: 

http://SMSQ.J-M-S.COM 


You will find links which lead you to a secure 
order form .. and the discounted price for 


QL Today readers (not just for upgrades but also 
for new orders) remains until March 2009. 


So, there | was, last issue, saying | was not 
going away and then, suddenly, everything 
changed. | suppose, in some way, | knew it had 
to but you do tend to keep putting things off 
and that really was the key to the problem | 
had. When, as a trader you get one or two 
orders in a three month period you think, ‘well | 
will do that tomorrow’ and that turns into after 
the weekend and then next week, you know 
that is not the right way to do things. | had two 
orders for QPC2 sitting on my desk for ages 
and one of them | had not even taken the mo- 
ney for The customers were patient, as most 
QL-people are but, in the end, | had to give 
myself a big shake and get on with it. It was at 
this point | decided that it was not fair on the 


A new feature of QMENU V8.01 is the possibility 
to specify the number of lines in the VIEW_FILE 
menu. You could always specify the number of 
characters, so why not.. looks good and seems 
to be working well.. one of the items on the 
wish-list from Bob Spelten. 

Another bug, reported by George Gwilt, in 
SYSTEM_SELECT (just visual, nothing crashes!), 
has been fixed too. 


| am thinking about a new QMENU menu which 
was suggest by Francois van Emelen: The idea is 
to show values in two columns next to each 
other the right column being editable. For 
example, to show results, or to be able to edit 
fields of a database (e.g. left column field name, 
right column editable value). 

| think, the best way would be to have two string 
arrays (one for the left column, or field names and 
one for the right column). 

Optional flags could specify if the right (or maybe 
left or even both columns) are editable ... or would 
it make sense to add a status array to set the 
editable flag individually for each item? 

| am in the stage of planning, so ideas and 
feedback are most welcome! 


Please send your emails to SMSQ@J-M-S.com or 
use the contact form on the J-M-S homepage. 


customers - few that they are - and decided 
QBranch had to shut its doors. 

| was reminded of a scene at a German QL show 
back in the mid 90's when Albin Hessler came up 
to Jochen and | and, almost tearfully, said he was 
going to have to stop programming for the QL. 
All things come to an end (except the M25 or the 
Paris Peripherique). 

The problems with the last issue of QL Today 
were of the same root. Because it was the first 
one of a new volume | had to go through the 
subscriber list and take out the ones which had 
not re-subscribed. | had to send out reminders to 
some people who, | was sure had just slipped up. 
After that | needed to get a final total so | could 


tell Jochen how many | was going to need. As 
most of you know I run the local branch of the 
British Sub Aqua Club as Diving Officer and have 
a very active rock n roll band. | compounded this 
by getting involved with a campaign to stop the 
local council turning Brighton Marina into a 
housing estate (still ongoing that one) and | have 
my family as well so | ran out of hours in the day. 
In the end the people who clamoured loudest for 
attention got it and | forgot to deal with the QL 
stuff. | apologise. 

So | took a deep breath and decided this would 
be the last issue | would advertise in and after 
Christmas | would completely stop all QL busi- 
ness. Not that there was that much anyway, 

It has been a good 12 years running the compa- 
ny and | have had a lot of fun with a lot of good 
people. | hope to stay in touch with a lot of them 
and | will still be using QPC2 on my PC. At the 
moment | am not sure if this will be the final co- 
lumn. As | said last time it has become increa- 
singly hard to write copy about purely QL sub- 
jects and | have not been able to fill a whole 
column with it for a while now. 


What Happened To All that 


Promise? 

Well, some of you may be wondering what ac- 
tually happened with the QL. | suspect it will not 
be many of you though. It should be fairly ob- 
vious that the progress of development stalled 
some years ago and, certainly for the last 
couple of years, no new products, updates or 
program versions have been issued. Lack of new 
stuff has lead to a lack of things to give talks 
about at shows and this, in turn, led to low 
attendance at those shows and their final demise. 
Is there anyone to blame? Well no, | don't think 
that there is. the QL-had reached the end of its 
useful life years ago. Long overtaken by faster 
processors, slicker software and better things. It 
has clung on to a tenuous existence in these 
pages and those of Quanta mainly by the good 
efforts of people like Jochen Merz, Dilwyn Jones 
and others like them. One of the biggest pro- 
blems has been that, as the pond shrunk so the 
fish got a little too big and a mite fractious. In 
those circumstances the minnows have tended 
to swim off and hide under the lilly pads - some- 
times never to emerge again. 

If all this sounds a little like sour grapes because | 
am now signing off from active service | can 
assure you that it isn't. There was a policy under 
most editors of the magazine not to include 
negative articles and | always felt that was a little 


wrong. Sometimes a negative viewpoint is what 
is needed to stimulate activity. It can actually be 
cathartic and stimulate fresh growth. 


Could We have Stopped the 


Decline? 

When the QL first emerged it was as good a 
contender as any for the crown. All computers in 
the early 80's were slow, flaky and had clunky 
software. The QL was as good as any of the 
others and better than most of them, in fact. 
There were a few design flaws and a dreadful 
marketing launch but, on the whole it was a good 
starting point. The trouble was that was all it was. 
Once off the mark it behaved just like a British 
Tennis player A few good shots then it was 
straight into the nets. These days nothing can 
touch a Wintel system - oh yes | can hear all the 
groans and moans and cries of the LINUX and 
MAC supporters out there but really, wake up 
and taste the horlicks. LINUX is an outright failure 
(| will come to that later) and MACs, while being 
basically good systems are overpriced and re- 
strictive. Musicians and designers love them but, 
step outside those niche areas and look at what 
is available for the MAC. Most street level stuff 
has to run under emulation. 

If you look at it with the rose glasses off the 
whole computer business is running on empty. 
Games consoles now account for the bulk of the 
gaming platforms and the home computer is an 
email terminal with access to the web for home- 
work, shopping, gambling, holiday and _ travel 
booking. The biggest innovation on the home 
computer in the last few years has been social 
networking on sites like Facebook and MySpace 
etc. All the stuff that kept people up all night 
Staring at a screen is now available on something 
else - even the fleshier pursuits. 

| would say, if pushed, that the real decline of our 
system set in when so many of the productive 
writers hung up their HEX and stopped innova- 
ting. There is no substitute for innovation to keep 
people interested. As a community we had our 
share of geek programmers and users. Many of 
these moved off into LINUX. | know | have said 
this before but programmers like Jonathan Hud- 
son in many ways fuelled the move away from 
the QL. If you provide something like QFAX with 
no proper front end you dangle a carrot before 
an average user that he cannot hope to cook. 
Trouble is he has seen the carrot, and, if another 
provider can do some carrot cake - with icing - 
he will go there. The same is true of a lot of 
QL-software. Small, compact and to the point it 


may be but Joe public loves a bell and a whistle 
even if he never blows them. 
This is all part of the LINUX argument too. 


LINUX 

So why do | say that LINUX is a failure? After all 
there are lots of computers out there running it. 
Quite a few of the netbook EEPCs run LINUX as 
a standard O/S and some of that is an active 
choice by the manufacturers although a lot of the 
activity is in deciding that adding another £50 
onto the cost for a copy of XP Home would push 
the price tag up too much. The small size of 
Solid State Memory available also added to this 
decision since Windoze does tend to take up a 
lot of space on a drive. 

The Netbook and things like it are ideal platforms 
for LINUX because they come complete. With no 
expansion slots or unusual hardware to bump up 
against or conflict with it is a good bet. It is also a 
platform for net use and is more of a, biggish, 
smartphone or electronic organiser than a com- 
puter so you won't be doing lots of complex 
stuff on it and won't feel the need for big or 
sophisticated programs. Ideal for LINUX then. 

It is on the desktop that LINUX just does not cut 
the ketchup - let alone the mustard. Linux itself 
was only ever going to be the system of choice 
for two types of user There is the hardware 
freak who loves tinkering with bits of electronics 
and can understand enough code to recompile a 
driver when one does not exist and there is the 
basic netbook user described above. Bit of Word 
Processing, email, net browsing, looking at pic- 
tures from your mobile phone. all fine - so long as 
you have someone who can set the thing up on 
the PC. UBUNTU is probably the easiest LINUX to 
set up but even that has its arcane corners in 
which lurk goblins in bottle glasses asking you 
obscure questions in unfeasibily squeaky voices. 
But compatibility....... Oh dear! Along comes a new 
printer / graphics card / or other shiny hardware 
device. Are you really going to wait 6 months for 
some dusty coder to get one for Christmas and 
decide to write a driver or interface for it? Of 
course the LINGANG will chiro up ‘write it 
yourself but that is not going to happen is it? 
Your talents probably lie elsewhere and you 
probably only have LINUX because someone 
talked you into it and set it up for you. Or 
because it was free. 

There are tools out there to helo you. Linspire’s 
Click and Run Warehouse is one but that is the 
work of the devil to many hardcore LINUX nuts. 
This is precisely why some QL-programmers 


moved to LINUX in the first place. A better, faster. 
hardware platform and people who did not want 
complete singing and dancing software handed 
to them on a platter The problem is that, for the 
manufacturers of hardware and the mass market 
software houses, there are not enough LINUX 
users out there to make it worth adding to the 
production costs by doing LINUX versions of the 
software or writing LINUX drivers and there are 
not enough people using it because there is not 
enough software or hardware for it. This is the 
QL problem in Macrocosm. We will never have 
any new hardware because there is not enough 
of a user base to pay for its development 


Security 

Talk to me about virus protection then. OK there 
are less nasty predators out there for LINUX and 
the MAC but then there are less of those out 
there to attack anyway. Of course if you consider 
that the average MAC user has slung at least 
four times the amount of money at his setup than 
the average PC user you might think the online 
‘phishers of men’ would be circling them with 
currency signs lighting up the eyes. It is not that 
they are so secure. Every O/S has a swathe of 
holes in it, unpatched bits that a good program- 
mer can hack into. They all have their vulnerabili- 
ties it is just that there are so many PCs running 
out there that it is easy to break into one. If we all 
switched to LINUX tomorrow then so would the 
virus writers and hackers and, oh look, there is all 
the code on display for them to hack. 

Three Dead Trolls In A Baggie summed up the 
general sentiment in a verse of its snappily 
named 2001 song Every OS Sucks 

‘It's free, they say, if you can get it to run The 
geeks say ‘Hey, that’s half the fun! Yeah, well | 
got a girlfriend and things to get done. The Linux 
OS sucks!’ 


Back to the Black Box Then 

As | said above a lot of the problems of LINUX 
are reflected in a small scale on the QL and, even 
worse, they are compounded by having a 
growing proportion of people who stick with the 
older programs when newer, better ones are 
available. | was sharply reminded of this recently. 
One of my older customers called me up and 
said he had some problems and could he come 
over to see me. He was using a QL with a Super 
Gold Card and an EPSON wide carriage dot 
matrix printer He used it purely for running 
ABACUS and the problems were 1. the printer did 
not print anymore 2. he could not read some of 


the disks 3. the QL was intermittently giving a 
corrupt screen 

Now | am no hardware repairer but | did have a 
spare QL here so problem 3 was easy. Problem 2 
was also a not a difficult one. He had two sets of 
floppy drives, one DD and one HD. He was using 
the DD one and formatting HD disks on it and 
doing the work on the HD drive which, of course, 
looked at the disk and said ‘the holes say it is HD 
but the tracks are wrong - must be corrupt’ Again 
easy to solve - tell him not to use the DD drives. 
Problem 1 was the stickler | could test the printer 
from my laptop using QPC2 (no Windows XP 
driver for a printer that old). That was OK and | 
found a small piece of paper jammed into one of 
the sensors. Cleared that and it worked fine. 
Luckily the laptop had a parallel port. Many don't 
these days. Having sorted that | tried it on his 
system again. Stil nothing. | always hated the 
PSION suite. It was all a bit flaky but, for its time, it 
was state of the art. 

| tried to run the printer edit program but, for the 
life of me, couldn't recall how to do it. | got fed up 
with trying to do that on a slow QL and tried to 
do it on the laptop using QPC2 but it fell over 
completely. In the end | downloaded a new 
version of the program and editing programs 
from Dilwyn’s site, edited the BASIC to give me 
floi_ and flp2_ instead of mdvi_ and mdv2_ and 
re-learnt how to do it. It took me all weekend to 
sort it out but | got it all back up and running. 
The crux of this story is this. The user also had a 
laptop and | suggested getting rid of the QL alto- 
gether, buying QPC2 and QPCPrint and running 
Exchange. As a demo | downloaded the QPC2 
demo program, set up a QXL_WIN file with 
Exchange and some of his data and showed him 
how to use it. 

It was faster than his standard QL. Would print 
onto his nice laser printer at home (well it would if 
he bought the full program - | dont think the 
demo will print) and he could store all the data on 
his hard drive. He went away to try it out and 
didn't ever get back in touch. He is probably still 
using his QL. 

If that is the general attitude why do we bother? 
Great innovation like QDT are not seized upon 
and the people left seem to exist in a computer 
museum - frozen in aspic. | reached the age of 60 
last week but | still want to take up new stuff and 
learn to use new equipment and | still want to 
move forward. | don't read the QL list as much as 
| used to but when | do | find the same topics 
rolling round. This week, for example, they were 
discussing the 36 character file name length. OK 
it is a tad short but, since no one is doing any- 


thing daring in the programming field, what does 
it matter? | wrote about that in this column way 
back - at least 10 years ago. 


Disagreements and disputes 

Over the years there have been a few spats and 
exchanges in QL Land. Usually someone with 
strong ideas clashing with a group of people 
who did not want any charge to the status quo 
(well Whatever You Want). Some of those spats 
were downright vicious at times and some appal- 
lingly childish but that is what happens in a small 
community with more than its share of single 
issue Obsessives. Some of these arguments lost 
us readers and users. There were the obsessivly 
open source programmers who threw wobblies 
when their programs were included on cover 
disks without the reams of source code. And 
then there was the argument about the SMSQ/E 
licence. At the original meeting | was of the 
opinion it should have been free and expressed 
that. Others disagreed and | went along with their 
decisions. From my point of view making it free 
but controlled was the best way to get more 
people using it and the more people that used it 
the more software would be written that used all 
its wonderful features. To be fair to those who 
wanted to charge for it, the decision was never 
about the money they could make because we 
alll knew it would not make any. 

There were that failed hardware projects. The 
Q40 could have been a great QL successor if 
only its developers had listened to Tony Firshman 
and Stuart Honeyball (both people who have 
provided the best hardware ever available for the 
QL) and treated it as a prototype and made a 
few, sensible changes to it. Egos, impatience in 
intractability got in the way. It was still a reasona- 
ble machine and a good deal better than a stan- 
dard QL but not the great thing it could have 
been. 

So | suppose | will bid farewell to all this. As | said 
at the start | am not sure if | will contribute a 
column for the next issue - time and motivation 
are a little short these days. My natural optimism 
hoped, at the start of QBranch, that the QL would 
pull something wonderful out of the bag. The 
potential was always there but it ebbed away. 
The QBrach email address will still operate so 
you can get in touch - replies may be slow, It 
depends on what time | have. 

| wish you all a Happy Christmas and and innova- 
tive New Year 

Goodbye, and thank you for all your support. 
(and the fish!) 


The fact that QBranch is closing the QL business 
means we need to think about the future of QL 
Today. 

Roy promised to deal with all forthcoming issues 
of Volume 13, but how are we going to continue 
after that? 

Well, it mainly depends on you, our readers. 

First, a bit of history and some more ‘insights’... | 
know | have explained some things when rene- 
wals were due and we had to raise the price. | do 
not want to raise the price again, so here are my 
ideas and considerations. 

As most of you Know, QL Today was brought to 
life when IQLR suddenly stopped. Stuart Honey- 
ball and | agreed that we had to have a magazine 
in order to keep the QL scene together and alive. 
13 years ago, the QL scene was auite active .. 
we had many traders and events ... a bit different 
from today’s situation. 

| was quite keen on producing the magazine, and 
so | did, with the help of many others ... mainly 
Dilwyn at that time. When we started, we had 
about 12 pages of advertising, so filling 56 to 60 
pages average was much easier It also meant 
that the money, which came in from the adverti- 
sing, could be used to keep the price of QL To- 
day down. Also, 13 years ago, postage, shipping, 
everything was much cheaper than nowadays. 
We started with 6 issues per year which was a 
lot. Stuart Honeyball mainly shipped the maga- 
zines to the very many UK readers those days, 
so the editorial work, proof reading etc. was 
shared between Dilwyn Jones and myself (larger 
share to Dilwyn), and | did all of the layout - of all 
issues. And | sent out the issues to all the rea- 
ders who subscribed through me all the time - 
which is also time consuming, especially for 
issues with cover disks or CDs (it took days to 
copy them!) 

| also produced German issues of QL today for 
several years. Also, 6 issues per volume, about 
1/3rd of the English volume .. with the help of 
Dietrich Buder (proof reading), but for a much 
smaller readership. In the beginning, | also added 
some sheets for the remainders of the QL Club 
Germany. Thinking about it, | wonder how | 
managed to do all this, time-wise. 


ares iS 


| don't know if it was a good decision or a bad 
one, looking at it from today. Most of my QL-ing 
time was eaten up by QL Today, so, unfortunately, 
not much time was left for programming and 
other QL activities. Also, QL Today did not really 
earn me any money .. so | was forced to do 
other things to earn money - like the Shareware. 
Which, again, meant that no time was left for QL 
programming. And, without updates and no pro- 
ducts, no QL income. Which resulted in more 
pressure to do other things to earn money. 

The number of readers decreased, Stuart Honey- 
ball ceased trading, and Roy Wood jumped in. 
Later Dilwyn had to stop being QL Today editor 
for personal reasons and Geoff Wicks became 
editor Everything went smoothly, and looking at 
the years, | think we did very well producing inter- 
esting magazines very much in time, well-looking, 
and very reliable. We lost advertisers, but we did 
not reduce the size of the magazine - in fact, we 
filled those pages with editorial content, articles 
etc. - so in the end the magazine became better 
value year by year. 

| think at the upcoming start of Volumes 8, 9 or 
10, when the time pressure was too high, we 
were suffering from lack of material for the ma- 
gazine, Roy talked me into continuing at the 6 
issue rate per year Easy for Roy, as it was | who 
had to spend all the time doing the layouts etc. 
But, good that he encouraged me to continue. It 
was Clear that 6 issues per year were impossible, 
so we went to 5, and now for two years, | think, 
to a quarterly base. Which is much better as we 
do not suffer from lack of material as badly as 
with 6 issues. | do enjoy producing the magazine 
much more again, especially compared to 3 
years ago or so when it was difficult to get 
enough material together. 

The financial situation, subscription price etc. has 
been explained in previous issues. The situation 
remains. When we set the subscription price at 
the middie of a year we do not know what is 
going to happen to the postage over the whole 
of the subscription year Printing prices have in- 
creased, the Dutch Post raises the price every 
year, mainly at the beginning of January, the UK 
post raises the prices every now and then and 
SO On. 


We have kept the price steady for the last vo- 
lume, although costs went up ... and you cannot 
‘only’ count the costs for producing the maga- 
zine and shipping, as | need to care about send- 
ing out renewal reminders (a letter to the USA 
costs EUR 1.70 ... | am not joking!), replacement of 
lost issues and other things. 

With volume 13, the number of readers has fallen 
under 200. The cost and time per issue goes up 
with every reader we lose. However, as | will be 
faced with dealing with all the renewals now 
(both from Roy and my own ones), | wonder what 
to do about Volume 14. Do YOU want a volume 
14? If so, how do we work out a fair price, not 
knowing how many readers we will have. To work 
out a fair price, we have to know how many 
readers will renew. So, we're stuck. 

When we had 500 readers or so, losing 10% 
caused much less influence to the price of the 
remaining issues than nowadays. The price for 
shipping the issues in a big package to the UK 
(so that Geoff can send them out to the readers, 
he already offered to do this) will be the same, for 
80, 120 or 150 ... but the per-issue price will 
nearly double between 80 and 150. 

As MY subscribers know, | always sent out early 
renewal reminders, but everybody who paid by 
credit card was charged after the last magazine 
of the previous issue was shipped for a while - 
usually May to July. 

Which options do we have? Electronic version of 
QL Today - not desired by the majority of readers 
- and speaking to others and knowing for myself 
- we are flooded with mails and junk mails and 
ads ... realistically, after 1 or 2 issues the result 
would not be honoured as much as a printed 
issue. And you cannot read an electronic issue 
the same way you can read paper ones, eg. 
while taking a bath, while sitting in the sun etc. 
And, not everybody is on the internet ... and if we 
go both ways, we just add work and increase the 
per-issue costs for printed issues considerably! 
SO, nO option for me. 

| also do not want to raise the price. Everybody 
has less money to spend, as everything is get- 
ting more and more expensive. Also no option 
for me. 

Would it make sense to wait for all renewals to 
arrive, decide if enough readers exist to justify 
the work and see, if the magazine can be pro- 
duced at a specified price, and only accept credit 
cards and account debit in Germany (so that, if 
the number is too small, nothing is done and we 
forget about QL Today?). Mmmhh, no option 
either, is it? 


So, the ONLY way to reduce the costs for the 
magazine is to reduce the weight of the maga- 
zine. The big postage difference comes over 
100g. At present, we are under 200g. | checked 
how many pages including envelope can be 
used to stay under 100g. The 160g/sqm cover 
paper could be replaced by 80g. Which would 
allow 32 pages maximum. 

So, opting for 32 pages maximum per issue 
would reduce postage, printing costs, ensure that 
we will be able to fill future issues {filing 56 to 60 
pages is not always easy, as you know), and 
would allow me to reduce the subscription price, 
instead of raising it. In my opinion, the only option. 
The remaining question is: do we go to DIN A5 
size, like Quanta? Actually, we would have more 
border, footers, headers, and | rather like the A4 
size. 

As none of us get any younger and our eyes 
most likely do not get any better either not a 
good option. We could - if you agree - reduce 
the average character size by 1 point. This should 
allow me to put over 10% more information on 
the same number of pages without reducing the 
text size too much ... going down to A5 gives 
much, much smaller text, or much less content. 
To compensate for the fewer pages even more, 
we could say that we do not print listings longer 
than 2 pages anymore, but publish them on the 
website when the magazine comes out, and add 
a disk or CD with issue 4 containing all the lis- 
tings for the readers without internet access. 
Does that sound like a good and fair option? We 
would have one heavier issue and more ex- 
pensive postage for issue 4 only, going this way. 
So, there we are. Assuming a moderate price in- 
crease and assuming that we do not lose many 
readers, we could bring the European sub- 
scription rate from EUR 33.90 down to something 
under 30 EUR (and | don't mean 29.99!) and the 
US rate from 44.90 EUR down by at least 10 EUR 
OF SO. 

| hope | have explained the reasons and the 
Situation and considerations as well as possible. 
We (Geoff and |) expect your feedback. We do 
want to continue QL Today, as you can see and 
as we feel, it is in important piece to keep the QL 
scene together as it is, but after all, it is done 
mainly for YOU. 

| cannot really finish this article without thanking 
Roy for all his encouragement and support, Dit 
wyn and Geoff, Bruce .. and all our authors and 
readers - all of you made and make the exis- 
tence of QL Today possible! 
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Quanta Annual General Meeting 2009 


QUANTA Committee confirms that the 


25th Annual General Meeting 


Will be held at the Allesley Hotel, Coventry, England. 
CV5 9GP 
Members are invited to attend the celebratory workshop opening Saturday April 18th and 
closing on Sunday April 19th 2009. The AGM will be held at 2.00 pm on Sunday. 
Nomination forms for committee members and officers are enclosed with the Quanta magazine. 


The programme will include: Talks, Interactive problem solving, Repair desk, Other activities 


A celebratory dinner will be held on Saturday night at 7.30 pm 
A number of rooms, single, double or twin have been provisionally booked for both Friday and Saturday 
night. Anyone wishing to come, please contact Quanta secretary Sarah Gilpin at secretary@QUANTA.org.uk 
Please state whether you wish to book a room, attend the dinner provide a talk or demonstration or 
Set up an activity 


The hotel is easily accessible from Birmingham Airport, so we hope our Overseas members will come and 
join us. Directions will be published in the next Quanta magazine or are available at: 
http://www.allesleyhotelcoventry.co.uk/Allesley_Coventry_Hotel_Directions.html 


All Quanta workshops were open to members and non-members in the past, so the QL Today team 
assumes that non-Quanta-members are welcome as well! 


MERRY CHRISTMAS | 
AND ALL THE BEST 
FOR 2009 TO OUR 
READERS FROM THE 
QL TODAY TEAM! 


lways, it depends on how quickly we get reviews, articles etc. 

You know, we are waiting for YOUR articles and feedback - the magazine lives from it. The more 
e get and the sooner we get it, the quicker the next issue will be in your hands, and the better 
will be. Hope to meet you at one of the 


